wizardforcel 





MyBatis 中 文 文档 3.4 


介绍 
参考 文档 
简介 
An 
XML 映射 配置 文件 
Mapper XML 文件 
动态 SQL 
Java API 
SQL 语句 构建 器 类 
Logging 
项 目 文档 
项 目 总 体 信息 
访问 
提醒 方法 
项 目 依 赖 


Dependency Information 


Overview 
问题 跟踪 
项 目 授权 
项 目 邮件 列表 


SE 


Project Plugin Management 


Project Build Plugins 
Project Report Plugins 


团队 
Web 访 问 
匿名 访问 
开发 者 访问 
通过 防火 墙 访问 
项 目 概 要 

生成 报表 


MyBatis 中 文 文档 3.4 


来 源 : MyBatis 中 文 文档 


参考 文档 


EK AN 
ja] JI 


什么 是 MyBatis ? 


MyBatis 是 支持 定制 化 SQL、 存 储 过 程 以 及 高 级 映射 的 优秀 的 持久 层 框架 。 
MyBatis 避免 了 几乎 所 有 的 JDBC 代码 和 手动 设置 参数 以 及 获取 结果 集 。MyBatis 
可 以 对 配置 和 原生 Map 使 用 简单 的 XML 或 注解 ， 将 接口 和 Java 的 POJOs(Plain 
Old Java Objects ,普通 的 Java 对 象 ) 映 射 成 数据 库 中 的 记录 。 


帮助 改进 文档 .… 


不 管 你 以 何 种 方式 发 现 了 文档 的 不 足 ， 或 是 丢失 对 某 一 特性 的 描述 ， 那 么 你 能 做 的 
最 好 的 事情 莫 过 于 去 研究 它 并 把 文档 写 出 来 。 


该 文档 xdoc 格式 的 源码 文件 可 通过 项 目的 Git 代码 库 来 获取 。Fork 该 源码 库 ， 做 
出 更 新 ， 然 后 提交 一 个 pull request 吧 。 


你 将 成 为 本 文档 的 最 佳作 者 ，MyBatis 的 用 户 定 会 过 来 查阅 的 。 


当前 的 国际 化 版 本 
MyBatis 的 其 他 语言 版 本 : 


English 
Espa?ol 
日 本 语 
22? 


简体 中 文 
你 想 使 用 本 地 语言 来 了 解 MyBatis 吗 ? 那 就 将 它 翻译 成 你 的 母语 并 提供 给 我 们 吧 | 


A" 

BR 

要 使 用 MyBatis, Ree mybatis-x.x.x.jar 文件 置 于 classpath 中 即 可 。 

如 果 使 用 Maven 来 构建 项 目 ， 则 需 将 下 面 的 dependency 代码 置 于 pom.xml 文件 
Hrs 


«dependency» 
«groupId»org.mybatis«/groupId» 
«artifactId»mybatis«/artifactId» 
«version»x.x.x«/version» 

«/dependency» 


从 XML 中 构建 SqlSessionFactory 


每 个 基于 MyBatis 的 应 用 都 是 以 一 个 SqlSessionFactory 的 实例 为 中 心 的 。 
SqlSessionFactory 的 实例 可 以 通过 SqlSessionFactoryBuilder 获得 。 而 
SqlSessionFactoryBuilder 则 可 以 从 XML 配置 文件 或 一 个 预先 定制 的 
Configuration 的 实例 构建 出 SqlSessionFactory 的 实例 。 


从 XML 文件 中 构建 SqlSessionFactory 的 实例 非常 简单 ， 建 议 使 用 类 路 径 下 的 资 
源 文件 进行 配置 。 但 是 也 可 以 使 用 任意 的 输入 流 (InputStream) 实 例 ， 包 括 字符 串 形 
式 的 文件 路 径 或 者 file:// 的 URL 形式 的 文件 路 径 来 配置 。MyBatis 包含 一 个 名 叫 
Resources 的 工具 类 ， 它 包含 一 些 实用 方法 ， 可 使 从 classpath 或 其 他 位 置 加 载 资 
源 文件 更 加 容易 。 


String resource = "org/mybatis/example/mybatis-config.xml"; 
InputStream inputStream = Resources.getResourceAsStream(resource); 
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStre: 


[ee  — A | 


XML 配置 文件 (configuration XML) 中 包含 了 对 MyBatis 系统 的 核心 设置 ， 包 含 
获取 数据 库 连 接 实例 的 数据 源 (DataSource) 和 决定 事务 范围 和 控制 方式 的 事务 管 
理 器 (TransactionManager) . XML 配置 文件 的 详细 内 容 后 面 再 探讨 ， 这 里 先 给 
出 一 个 简单 的 示例 : 





«?xml version="1.0" encoding-"UTF-8" ?> 
<!DOCTYPE configuration 
PUBLIC "-//mybatis.org//DTD Config 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-config.dtd"> 
<configuration> 
<environments default="development"> 
<environment id="development"> 
«transactionManager type="JDBC"/> 
<dataSource type="POOLED"> 
«property name="driver" value="${driver}"/> 
«property name="url" value="${url}"/> 
«property name="username" value="${username}"/> 
«property name="password" value="${password}"/> 
</dataSource> 
</environment> 
</environments> 
<mappers> 
«mapper resource="org/mybatis/example/BlogMapper . xm1"/> 
</mappers> 
</configuration> 


当然 ， 还 有 很 多 可 以 在 XML 文件 中 进行 配置 ， 上 面 的 示例 指出 的 则 是 最 关键 的 部 
分 。 要 注意 XML 头 部 的 声明 ， 用 来 验证 XML 文档 正确 性 。environment 元 素 体 中 
包含 了 事务 管理 和 连接 池 的 配置 。mappers 元 素 则 是 包含 一 组 mapper 映射 器 (这 
些 mapper 的 XML 文件 包含 了 SQL 代码 和 映射 定义 信息 ) 。 


不 使 用 XML 构建 SqlSessionFactory 


如 果 你 更 愿意 直接 从 Java 程序 而 不 是 XML 文件 中 创建 configuration， 或 者 创建 你 
自己 的 configuration 构建 器 ，MyBatis 也 提供 了 完整 的 配置 类 ， 提 供 所 有 和 XML 
文件 相同 功能 的 配置 项 。 


DataSource dataSource = BlogDataSourceFactory.getBlogDataSource(); 
TransactionFactory transactionFactory = new JdbcTransactionFactoryi 
Environment environment = new Environment("development", transactic 
Configuration configuration - new Configuration(environment); 
configuration.addMapper(BlogMapper.class); 

SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder | 
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注意 该 例 中 ，configuration 添加 了 一 个 映射 器 类 (mapper class) 。 上 映射 器 类 是 
Java 类 ， 它 们 包含 SQL 映射 语句 的 注解 从 而 避免 了 XML 文件 的 依赖 。 不 过 ， 由 
于 Java 注解 的 一 些 限制 加 之 某 些 MyBatis 映射 的 复杂 性 ，XML 映射 对 于 大 多 数 高 
级 映射 (比如 : BRE Join 上 映射) 来 说 仍然 是 必须 的 。 有 鉴于 此 ， 如 果 存 在 一 个 对 等 
的 XML 配置 文件 的 话 ，MyBatis 会 自动 查找 并 加 载 它 (这 种 情况 下 ， 
BlogMapperxml 将 会 基于 类 路 径 和 BlogMapper.class 的 类 名 被 加 载 进 来 ) 。 具 体 
细节 稍 后 讨论 。 


从 SqlSessionFactory 中 获取 SqlSession 
既然 有 了 SqlSessionFactory ， 顾 名 思 义 ， 我 们 就 可 以 从 中 获得 SqlSession 的 实 


例 了 。SqlSession 完全 包含 了 面向 数据 库 执行 SQL 命令 所 需 的 所 有 方法 。 你 可 以 
通过 SqlSession 实例 来 直接 执行 已 映射 的 SQL 语句 。 例 如 : 


SqlSession session = sqlSessionFactory.openSession(); 


try 1 

Blog blog = (Blog) session.selectOne("org.mybatis.example.BlogMa[ 
) finally ( 

session.close(); 
} 


LEN: 


诚然 这 种 方式 能 够 正常 工作 ， 并 且 对 于 使 用 旧版 本 MyBatis 的 用 户 来 说 也 比较 熟 
悉 ， 不 过 现在 有 了 一 种 更 直 白 的 方式 。 使 用 对 于 给 定语 句 能 够 合理 描述 参数 和 返回 
值 的 接口 (比如 说 BlogMapper.class) ， 你 现在 不 但 可 以 执行 更 清晰 和 类 型 安全 的 
代码 ， 而 且 还 不 用 担心 易 错 的 字符 串 字 面值 以 及 强制 类 型 转换 。 


例如 : 





SqlSession session = sqlSessionFactory.openSession(); 


try ( 
BlogMapper mapper - session.getMapper(BlogMapper.class); 
Blog blog = mapper.selectBlog(101); 

) finally ( 
session.close(); 


H 
现在 我 们 来 探究 一 下 这 里 到 底 是 怎么 执行 的 。 


探究 已 映射 的 SQL 语句 


现在 ， 或 许 你 很 想 知道 SqlSession 和 Mapper 到 底 执 行 了 什么 操作 ， 而 SQL 语句 
映射 是 个 相当 大 的 话题 ， 可 能 会 占 去 文档 的 大 部 分 篇 幅 。 不 过 为 了 让 你 能 够 了 解 个 
大 概 ， 这 里 会 给 出 几 个 例子 。 


在 上 面 提 到 的 两 个 例子 中 ， 一 个 语句 应 该 是 通过 XML 定义 ， 而 另外 一 个 则 是 通过 
注解 定义 。 先 看 XML 定义 这 个 ， 事 实 上 MyBatis 提供 的 全 部 特性 可 以 利用 基于 
XML 的 映射 语言 来 实现 ， 这 使 得 MyBatis 在 过 去 的 数 年 间 得 以 流行 。 如 果 你 以 前 
用 过 MyBatis， 这 个 概念 应 该 会 比较 熟悉 。 不 过 XML 映射 文件 已 经 有 了 很 多 的 改 
进 ， 随 着 文档 的 进行 会 您 发 清晰 。 这 里 给 出 一 个 基于 XML 映射 语句 的 示例 ， 它 应 
该 可 以 满足 上 述 示例 中 SqlSession 的 调用 。 


<?xml version="1.0" encoding-"UTF-8" ?> 
<!DOCTYPE mapper 
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 
<mapper namespace="org.mybatis.example.BlogMapper"> 
<select id="selectBlog" resultType="Blog"> 
select * from Blog where id = #{id} 
</select> 
</mapper> 


对 于 这 个 简单 的 例子 来 说 似乎 有 点 小 题 大 做 了 ， 但 实际 上 它 是 非常 轻 量 级 的 。 在 一 
个 XML 映射 文件 中 ， 你 想 定 义 多 少 个 映射 语句 都 是 可 以 的 ， 这 样 下 来 ，XML 头 部 
和 文档 类 型 声明 占 去 的 部 分 就 显得 微不足道 了 。 文 件 的 剩余 部 分 县 有 很 好 的 自 解释 
性 。 在 命名 空间 “com.mybatis.example.BlogMapper" 中 定义 了 一 个 名 

为 “selectBlog” 的 映射 语句 ， 这 样 它 就 允许 你 使 用 指定 的 完全 限定 

名 “org.mybatis.example.BlogMapper.selectBlog” 来 调用 映射 语句 ， 就 像 上 面 的 例子 
中 做 的 那样 : 


Blog blog = (Blog) session.selectOne("org.mybatis.example.BlogMappe 
le 


你 可 能 注意 到 这 和 使 用 完全 限定 名 调用 Java 对 象 的 方法 是 相似 的 ， 之 所 以 这 样 做 
是 有 原因 的 。 这 个 命名 可 以 直接 映射 到 在 命名 空间 中 同名 的 Mapper 类 ， 并 在 已 映 
射 的 select 话 句 中 的 名 字 、 参 数 和 返回 类 型 匹配 成 方法 。 这 样 你 就 可 以 向 上 面 那样 
很 容易 地 调用 这 个 对 应 Mapper 接口 的 方法 。 不 过 让 我 们 再 看 一 通 下 面 的 例子 : 





BlogMapper mapper = session.getMapper(BlogMapper.class); 
Blog blog = mapper.selectBlog(101); 


第 二 种 方法 有 很 多 优势 ， 首 先 它 不 是 基于 字符 串 常 量 的 ， 就 会 更 安全 ; HR, MR 
你 的 IDE 有 代码 补 全 功能 ， 那 么 你 可 以 在 有 了 已 映射 SQL 语句 的 基础 之 上 利用 这 


个 功能 。 
提示 命名 空间 的 一 点 注释 


ZR 
命名 空间 (Namespaces) 在 之 前 版 本 的 MyBatis 中 是 可 选 的 ， 容 易 引 起 混淆 因此 
是 没有 益处 的 。 现 在 的 命名 空间 则 是 必须 的 ， 目 的 是 希望 能 比 只 是 简单 的 使 用 更 长 
的 完全 限定 名 来 区 分 语句 更 进一步 。 


命名 空间 使 得 你 所 见 到 的 接口 绑 定 成 为 可 能 ， 尽 管 你 觉得 这 些 东 西 未 必用 得 上 ， 你 
还 是 应 该 遵循 这 里 的 规定 以 防 哪 天 你 改变 了 主意 。 出 于 长 远 考 虑 ， 使 用 命名 空间 ， 
并 将 它 置 于 合适 的 Java 包 命 名 空间 之 下 ， 你 将 拥有 一 份 更 加 整洁 的 代码 并 提高 
MyBatis 的 可 用 性 。 


命名 解析 : 为 了 减少 输入 量 ，MyBatis 对 所 有 的 命名 配置 元 素 (包括 语句 ， 结 果 映 
St, RFS) 使 用 了 如 下 的 命名 解析 规则 。 


完全 限定 名 (比如 “com.mypackage.MyMapper.selectAllThings”) 将 被 直接 查 
找 并 且 找 到 即 用 。 

HAE (比如 “selectAllThings”) 如 果 全 局 唯一 也 可 以 作为 一 个 单独 的 引用 。 如 
果 不 唯一 ， 有 两 个 或 两 个 以 上 的 相同 名 称 (比如 “com .foo.selectAliThings 

"和 “com.bar.selectAllThings”) ， 那 么 使 用 时 就 会 收 到 错误 报告 说 短 名 称 是 不 

唯一 的 ， 这 种 情况 下 就 必须 使 用 完全 限定 名 。 


对 于 像 BlogMapper 这 样 的 映射 器 类 (Mapper class) 来 说 ， 还 有 另 一 招来 处 理 。 
它们 的 映射 的 语句 可 以 不 需要 用 XML 来 做 ， 取 而 代 之 的 是 可 以 使 用 Java 注解 。 比 
如 ， 上 面 的 XML 示例 可 被 替换 如 下 : 


package org.mybatis.example; 

public interface BlogMapper { 
@Select("SELECT * FROM blog WHERE id = #{id}") 
Blog selectBlog(int id); 

j 


对 于 简单 语句 来 说 ， 注 解 使 代码 显得 更 加 简洁 ， 然 而 Java 注解 对 于 稍微 复杂 的 语 
句 就 会 力不从心 并 且 会 显得 更 加 混乱 。 因 此 ， 如 果 你 需要 做 很 复杂 的 事情 ， 那 么 最 
好 使 用 XML 来 映射 语句 。 


选择 何 种 方式 以 及 映射 语句 的 定义 的 一 致 性 对 你 来 说 有 多 重要 这 些 完全 取决 于 你 和 
你 的 团队 。 换 名 话说， 永远 不 要 拘泥 于 一 种 方式 ， 你 可 以 很 轻松 的 在 基于 注解 和 
XML 的 语句 映射 方式 间 自 由 移植 和 切换 。 


范围 (Scope) 和 生命 周期 


理解 我 们 目前 已 经 讨论 过 的 不 同 范围 和 生命 周期 类 是 至 关 重 要 的 ， 因 为 错误 的 使 用 
会 导致 非常 严重 的 并 发 问题 。 


提示 对 象 生命 周期 和 依赖 注入 框架 


依赖 注入 框架 可 以 创建 线程 安全 的 、 基 于 事务 的 SqlSession 和 映射 器 (mapper) 
并 将 它们 直接 注入 到 你 的 bean 中 ， 因 此 可 以 直接 忽略 它们 的 生命 周期 。 如 果 对 如 
何 通过 依赖 注入 框架 来 使 用 MyBatis 感 兴趣 可 以 研究 一 下 MyBatis-Spring 或 
MyBatis-Guice 两 个 子 项 目 。 


SqlSessionFactoryBuilder 


这 个 类 可 以 被 实例 化 、 使 用 和 丢弃 ， 一 旦 创建 了 SqlSessionFactory， 就 不 再 需要 
它 了 。 因 此 SqlSessionFactoryBuilder 实例 的 最 佳 范 围 是 方法 范围 (也 就 是 局 部 方 
法 变量 ) 。 你 可 以 重用 SqlSessionFactoryBuilder 来 创建 多 个 SqlSessionFactory 
Sa a i XML 解析 资源 开放 给 更 重要 


SqlSessionFactory 


SqlSessionFactory 一 旦 被 创建 就 应 该 在 应 用 的 运行 期 间 一 直 存 在 ， 没 有 任何 理由 
对 它 进 行 清除 或 重建 。 使 用 SqlSessionFactory 的 最 佳 实践 是 在 应 用 运行 期 间 不 要 
重复 创建 多 次 ， 多 次 重建 SqlSessionFactory 被 视 为 一 种 代码 * 坏 味道 (bad 
smell) ”. AHE SqlSessionFactory 的 最 佳 范 围 是 应 用 范围 。 有 很 多 方法 可 以 做 
到 ， 最 简单 的 就 是 使 用 单 例 模 式 或 者 静态 单 例 模式 。 


SqlSession 


每 个 线程 都 应 该 有 它 自己 的 SqlSession 实例 。SqlSession 的 实例 不 是 线程 安全 
的 ， 因 此 是 不 能 被 共享 的 ， 所 以 它 的 最 佳 的 范围 是 请 求 或 方法 范围 。 绝 对 不 能 将 
SqlSession 实例 的 引用 放 在 一 个 类 的 静态 域 ， 其 至 一 个 类 的 实例 变量 也 不 行 。 也 绝 
不 能 将 SqlSession 实例 的 引用 放 在 任何 类 型 的 管理 范围 中 ， 上 比如 Serlvet 架构 中 的 
HttpSession。 如 果 你 现在 正在 使 用 一 种 Web 框架 ， 要 考虑 SqlSession 放 在 一 个 
和 HTTP 请 求 对 象 相似 的 范围 中 。 换 名 话说 ， 每 次 收 到 的 HTTP 请 求 ， 就 可 以 打开 
一 个 SqlSession， 返 回 一 个 响应 ， 就 关闭 它 。 这 个 关闭 操作 是 很 重要 的 ， 你 应 该 把 
这 个 关闭 操作 放 到 finally 块 中 以 确保 每 次 都 能 执行 关闭 。 下 面 的 示例 就 是 一 个 确保 
SqlSession 关闭 的 标准 模式 : 


SqlSession session = sqlSessionFactory.openSession(); 


try { 
// do work 

} finally { 
session.close(); 


} 


在 你 的 所 有 的 代码 中 一 致 性 地 使 用 这 种 模式 来 保证 所 有 数据 库 资 源 都 能 被 正确 地 关 
闭 。 


映射 器 实例 (Mapper Instances) 


映射 器 是 创建 用 来 绑 定 映射 语句 的 接口 。 映 射 器 接口 的 实例 是 从 SqlSession 中 获 

得 的 。 因 此 从 技术 层面 讲 ， 映 射 器 实例 的 最 大 范围 是 和 SqlSession 相同 的 ， 因 为 

它们 都 是 从 SqlSession 里 被 请 求 的 。 尽 管 如 此 ， 了 映射 器 实例 的 最 佳 范围 是 方法 范 

围 。 也 就 是 说 ， 了 映射 器 实例 应 该 在 调用 它们 的 方法 中 被 请 求 ， 用 过 之 后 即 可 废弃 。 

并 不 需要 显 式 地 关闭 映射 器 实例 ， 尽 管 在 整个 请 求 范围 (request scope) 保持 映射 
器 实例 也 不 会 有 什么 问题 ， 但 是 很 快 你 会 发 现 ， 像 SqlSession 一 样 ， 在 这 个 范围 

上 管理 太 多 的 资源 的 话 会 难于 控制 。 所 以 要 保持 简单 ， 最 好 把 映射 器 放 在 方法 范围 
(method scope) 内 。 下 面 的 示例 就 展示 了 这 个 实践 : 


SqlSession session = sqlSessionFactory.openSession(); 

try { 
BlogMapper mapper = session.getMapper(BlogMapper.class); 
// do work 

} finally { 
session.close(); 


} 


MyBatis 中 文 文档 3.4 


AN 


XML 映射 配置 文件 


MyBatis 的 配置 文件 包含 了 影响 MyBatis 行为 甚 深 的 设置 (settings) 和 属性 
(properties) 信息 。 文 档 的 顶层 结构 如 下 : 


e configuration 配置 
o properties 属性 
o settings 设置 
typeAliases 类 型 命名 
typeHandlers 类 型 处 理 器 
objectFactory 对 象 工厂 
plugins 插件 
environments 环境 
= environment 环境 变量 
= transactionManager 事务 管理 器 
= dataSource 数据 源 
o databaseldProvider 数据 库 厂 商标 识 
o mappers 映射 器 


O O O 0 0 


properties 


这 些 属 性 都 是 可 外 部 配置 且 可 动态 替换 的 ， 既 可 以 在 典型 的 Java 属性 文件 中 配 
置 ， 亦 可 通过 properties 元 素 的 子 元 素来 传递 。 例 如 : 


«properties resource="org/mybatis/example/config.properties"> 
<property name="username" value="dev_user"/> 
«property name="password" value="F2Fa3!33TYyg"/> 
</properties> 


其 中 的 属性 就 可 以 在 整个 配置 文件 中 使 用 来 蔡 换 需要 动态 配置 的 属性 值 。 比 如 : 


<dataSource type="POOLED"> 
«property name="driver" value="${driver}"/> 
«property name="url" value="${url}"/> 
«property name="username" value="${username}"/> 
<property name="password" value="${password}"/> 
</dataSource> 


这 个 例子 中 的 username 和 password 将 会 由 properties 元 素 中 设置 的 相应 值 来 替 
换 。 driver 和 url 属性 将 会 由 config.properties 文件 中 对 应 的 值 来 替换 。 这 样 就 为 
配置 提供 了 诸多 灵活 选择 。 


属性 也 可 以 被 传递 到 SqlSessionBuilderbuild() 方 法 中 。 例 如 : 


SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, 

LR e 

SqlSessionFactory factory = sqlSessionFactoryBuilder.build(reader, 
“| 
如 果 属 性 在 不 只 一 个 地 方 进行 了 配置 ， 那 么 MyBatis 将 按照 下 面 的 顺序 来 加 载 : 


e 在 properties 元 素 体 内 指定 的 属性 首先 被 读 取 。 

e 然后 根据 properties 元 素 中 的 resource 属性 读 取 类 路 径 下 属性 文件 或 根据 url 
属性 指定 的 路 径 污 取 属 性 文件 ， 并 覆盖 已 读 取 的 同名 属性 。 

e 最 后 读 取 作为 方法 参数 传递 的 属性 ， 并 覆盖 已 读 取 的 同名 属性 。 


因此 ， 通 过 方法 参数 传递 的 属性 具有 最 高 优先 级 ，resource/url 属性 中 指定 的 配置 
文件 次 之 ， 最 低 优 先 级 的 是 properties 属性 中 指定 的 属性 。 








settings 


这 是 MyBatis 中 极为 重要 的 调整 设置 ， 它 们 会 改变 MyBatis 的 运行 时 行为 。 下 表 描 
述 了 设置 中 各 项 的 意图 、 默 认 值 等 。 


设置 参数 描述 有 效 值 


该 配置 影响 的 所 有 
cacheEnabled 映射 器 中 配置 的 缓 true | false 
存 的 全 局 开关 。 


延迟 加 载 的 全 局 开 

K BAB, AT 

有 关联 对 象 都 会 延 
lazyLoadingEnabled true | false 

iB fetchType 属 

性 来 覆盖 该 项 的 开 

关 状 态 。 


当 启 用 时 ， 对 任意 
延迟 属性 的 调用 会 
| l 使 带 有 延迟 加 载 属 
aggressiveLazyLoading 性 的 对 象 完整 加 true | false 
载 ; 反之 ， 每 种 属 
性 将 会 按 需 加 载 。 
是 否 允 许 单一 语句 
multipleResultSetsEnabled 返回 多 结果 集 (E true | false 
要 兼容 驱动 ) 。 


使 用 列 标签 代替 列 


useColumnLabel 


useGeneratedKeys 


autoMappingBehavior 


defaultExecutorType 


defaultStatementTimeout 


defaultFetchSize 


名 。 不 同 的 驱动 在 
这 方面 会 有 不 同 的 
表现 ， 具体 可 参考 
相关 驱动 文档 或 通 
过 测试 这 两 种 不 同 
的 模式 来 观察 所 用 
驱动 的 结果 。 


允许 JDBC 支持 自 
动 生 成 主键 ， 需 要 
驱动 兼容 。 如 果 设 
置 为 true 则 这 个 设 
置 强制 使 用 自动 生 
成 主键 ， 尽 管 一 些 
驱动 不 能 兼容 但 仍 
MESE CLEAN 
Derby) 。 


指定 MyBatis 应 如 
何 自 动 映射 列 到 字 
段 或 属性 。 NONE 
表示 取消 自动 映 
射 ; PARTIAL 只 会 
自动 映射 没有 定义 
BUR HE REMATÓ 
结果 集 。 FULL 会 
自动 映射 任意 复杂 
的 结果 集 (无 论 是 
SHE), 


配置 默认 的 执行 
器 。SIMPLE 就 是 
普通 的 执行 器 ; 
REUSE 执行 器 会 
重用 预 处 理 语句 
(prepared 
statements) ; 
BATCH 执行 器 将 
重用 语句 并 执行 批 
量 更 新 。 


设置 超时 时 间 ， 它 
决定 驱动 等 竺 数据 
库 响 应 的 秒 数 。 


Sets the driver a 
hint as to control 
fetching size for 
return results. This 
parameter value 


true | false 


true | false 


NONE, PARTIAL, FULL 


SIMPLE REUSE 
BATCH 


Any positive integer 


Any positive integer 


safeRowBoundsEnabled 


mapUnderscoreToCamelCase 


localCacheScope 


jdbcTypeForNull 


lazyLoadTriggerMethods 


defaultScriptingLanguage 


can be override by 
a query setting. 


if TERRE i DA 
使 用 分 页 
(RowBounds) 。 


是 否 开启 自动 驼峰 
命名 规则 (camel 
case) 映射 ， 即 从 
经 典 数据 库 列 名 
A_COLUMN 到 经 
典 Java 属性 名 
aColumn 的 类 似 映 
Ho 


MyBatis 利用 本 地 
缓存 机 制 (Local 
Cache) 防止 循环 
引用 (circular 
references) 和 加 
RBS RES Mo 
默认 值 为 
SESSION， 这 种 
情况 下 会 缓存 一 个 
会 话 中 执行 的 所 有 
查询 。 若 设 置 值 为 
STATEMENT， 本 
地 会 话 仅 用 在 语句 
执行 上 ， 对 相同 
SqlSession 的 不 同 
20025598 
m 


当 没 有 为 参数 提供 
特定 的 JDBC 类 型 
时 ， 为 空 值 指定 
JDBC 类 型 。 某 些 
驱动 需要 指定 列 的 
JDBC 类 型 ， 多 数 
情况 直接 用 一 般 类 
型 即 可 ， 比 如 
NULL、VARCHAR 
或 OTHER。 


指定 哪个 对 象 的 方 
法 触发 一 次 延迟 加 
载 。 


指定 动态 SQL 生 


true | false 


true | false 


SESSION | 
STATEMENT 


JdbcType enumeration. 
Most common are: 
NULL, VARCHAR and 
OTHER 


Amethod name list 
separated by commas 


A type alias or fully 


defaultScriptingLanguage 


callSettersOnNulls 


logPrefix 


logimpl 


proxyFactory 


vfsImpl 


成 的 默认 语言 。 


指定 当 结 果 集 中 值 
为 null 的 时 候 是 否 
调用 映射 对 象 的 
setter (map 对 象 
时 为 put) 方法 ， 
这 对 于 有 
Map.keySet() 依赖 
或 null 值 初始 化 的 
时 候 是 有 用 的 。 注 
意 基 本 类 型 (int. 
boolean 等 ) 是 不 
能 设置 成 null 的 。 


指定 MyBatis 增加 
到 日 志 名 称 的 前 


Ho 


指定 MyBatis 所 用 
日 志 的 具体 实现 ， 
未 指定 时 将 自动 查 
找 。 


指定 Mybatis 创建 
具有 延迟 加 载 能 力 
的 对 象 所 用 到 的 代 
理工 具 。 


Specifies VFS 
implementations 


一 个 配置 完整 的 settings 元 素 的 示例 如 下 : 


qualified class name. 


true | false 


Any String 


SLF4J | LOG4J | 
LOG4J2 | 

JDK LOGGING | 
COMMONS LOGGING 
| STDOUT. LOGGING | 
NO LOGGING 


CGLIB | JAVASSIST 


Fully qualified class 
names of custom VFS 
implementation 
separated by commas. 


<settings> 


<setting name="cacheEnabled" value="true"/> 

«setting name="lazyLoadingEnabled" value="true"/> 
«setting name-"multipleResultSetsEnabled" value="true"/> 
«setting name-"useColumnLabel" value="true"/> 

«setting name-"useGeneratedKeys" value="false"/> 
«setting name="autoMappingBehavior" value="PARTIAL"/> 
<setting name="defaultExecutorType" value="SIMPLE"/> 
<setting name="defaultStatementTimeout" value="25"/> 
«setting name-"defaultFetchSize" value="100"/> 


«setting name-"safeRowBoundsEnabled" value="false"/> 
«setting name-"mapUnderscoreToCamelCase" value="false"/> 
«setting name="localCacheScope" value="SESSION"/> 
«setting name="jdbcTypeForNull" value="OTHER"/> 


<setting 


name-"lazyLoadTriggerMethods" value="equals, clone, hashCc 


</settings> 


o | 





typeAliases 


类 型 别名 是 为 Java 类 型 设置 一 个 短 的 名 字 。 它 只 和 XML 配置 有 关 ， 存 在 的 意义 仅 
在 于 用 来 减少 类 完全 限定 名 的 元 余 。 例 如 : 


<typeAliases> 
«typeAlias alias="Author" type="domain.blog.Author"/> 
«typeAlias alias="Blog" type="domain.blog.Blog"/> 
«typeAlias alias="Comment" type="domain.blog.Comment"/> 
<typeAlias alias="Post" type="domain.blog.Post"/> 
<typeAlias alias="Section" type="domain.blog.Section"/> 
<typeAlias alias="Tag" type="domain.blog.Tag"/> 

</typeAliases> 


当 这 样 配 置 时 ， Blog 可 以 用 在 任何 使 用 domain.blog.Blog 的 地 方 。 
也 可 以 指定 一 个 包 名 ，MyBatis 会 在 包 名 下 面 搜索 需要 的 Java Bean， 比 如 : 


<typeAliases> 
<package name="domain.blog"/> 
</typeAliases> 


每 一 个 在 包 domain.blog 中 的 Java Bean， 在 没有 注解 的 情况 下 ， 会 使 用 Bean 
的 首 字母 小 写 的 非 限定 类 名 来 作为 它 的 别名 。 比如 domain.blog.Author 的 别 
名 为 author ; 若 有 注解 ， 则 别名 为 其 注解 值 。 看 下 面 的 例子 : 


QAlias("author") 
public class Author { 


j 


已 经 为 许多 常见 的 Java 类 型 内 建 了 相应 的 类 型 别名 。 它 们 都 是 大 小 写 不 敏感 的 ， 
需要 注意 的 是 由 基本 类 型 名 称 重复 导致 的 特殊 义理 。 


_integer 
_ double 
_float 

_ boolean 
string 
byte 

long 
short 

int 
integer 
double 
float 
boolean 
date 
decimal 
bigdecimal 
object 
map 
hashmap 
list 
arraylist 
collection 


iterator 


typeHandlers 


映射 的 类 型 


double 
float 
boolean 
String 
Byte 

Long 
Short 
Integer 
Integer 
Double 
Float 
Boolean 
Date 
BigDecimal 
BigDecimal 
Object 
Map 
HashMap 
List 
ArrayList 
Collection 


lterator 


无 论 是 MyBatis 在 预 处理 语 句 (PreparedStatement) 中 设置 一 个 参数 时 ， 还 是 从 
结果 集中 取出 一 个 值 时 ， 都 会 用 类 型 处 理 器 将 获取 的 值 以 合适 的 方式 转换 成 Java 
类 型 。 下 表 描 述 了 一 些 默认 的 类 型 处 理 器 。 


类 型 处 理 器 Java 类 型 JDBC 类 型 
java.lang.Boolean , 数据 库 兼 容 的 
BooleanTypeHandler a BOOLEAN 
数据 库 兼 容 的 
ByteTypeHandler Na NUMERIC 或 
y BYTE 
数据 库 兼 容 的 
ShortTypeHandler EES j NUMERIC 或 
SHORT INTEGER 
数据 库 兼 容 的 
IntegerTypeHandler e j NUMERIC 或 
INTEGER 
; 数据 库 兼 容 的 
LongTypeHandler i E i NUMERIC 或 
9 LONG INTEGER 
e 数据 库 兼 容 的 
FloatTypeHandler E EES NUMERIC 或 
float 
FLOAT 
数据 库 兼 容 的 
DoubleTypeHandler EES, NUMERIC 或 
double 
DOUBLE 
TIUS ERA 
BigDecimalTypeHandler java.math.BigDecimal NUMERIC EX 
DECIMAL 
. 1 : CHAR , 
StringTypeHandler java.lang.String VARCHAR 
à A CHOBE: 
ClobTypeHandler java.lang.String LONGVARCHAR 
" p : NVARCHAR , 
NStringTypeHandler java.lang.String NCHAR 
NClobTypeHandler java.lang.String NCLOB 
ye Ga ^ rix 
ByteArrayTypeHandler byte[] Eug Ee 
流 类 型 
BlobTypeHandler byte[] GE 


LONGVARBINARY 


DateTypeHandler 
DateOnlyTypeHandler 
TimeOnlyTypeHandler 
SqlTimestampTypeHandler 
SqlDateTypeHandler 
SqlTimeTypeHandler 


ObjectTypeHandler 


EnumTypeHandler 


EnumOrdinalTypeHandler 


java. 
java. 
java. 
java. 
java. 


java. 


Any 


util.Date 
util.Date 
util.Date 
sql.Timestamp 
sql.Date 


sql.Time 


Enumeration Type 


Enumeration Type 


TIMESTAMP 
DATE 
TIME 
TIMESTAMP 
DATE 
TIME 


OTHER 或 未 指 


定 类 型 
VARCHAR- 任 何 
兼容 的 字符 串 类 
型 ， 存 储 枚 举 的 
称 (而 不 是 索引 ) 


任何 兼容 的 


NUMERIC 或 
DOUBLE 类 型 ， 


存储 枚 举 的 索引 


(而 不 是 名 称 ) 。 


你 可 以 重 守 类 型 处 理 器 或 创建 你 自己 的 类 型 处 理 器 来 处 理 不 支持 的 或 非 标 准 的 类 
型 。 具体 做 法 为 : 实现 org.apache.ibatis.type.TypeHandler 接口 ， 或 继承 


一 个 很 便利 的 类 


性 地 将 它 映射 到 一 个 JDBC 类 型 。 比 如 : 


org.apache.ibatis.type.BaseTypeHandler , 


然后 可 以 选择 


// ExampleTypeHandler.java 
QMappedJdbcTypes( JdbcType.VARCHAR) 
public class ExampleTypeHandler extends BaseTypeHandler<String> { 


QOverride 
public void setNonNullParameter(PreparedStatement ps, int i, Str: 
ps.setString(i, parameter); 


j 


QOverride 
public String getNullableResult(ResultSet rs, String columnName) 
return rs.getString(columnName); 


j 


QOverride 
public String getNullableResult(ResultSet rs, int columnIndex) tl 
return rs.getString(columnIndex); 


3 


QOverride 
public String getNullableResult(CallableStatement cs, int column: 
return cs.getString(columnIndex); 





<!-- mybatis-config.xml --> 
<typeHandlers> 


«typeHandler handler="org.mybatis.example.ExampleTypeHandler"/> 
</typeHandlers> 


EA Y) 


使 用 这 个 的 类 型 处 理 器 将 会 覆盖 已 经 存在 的 处 理 Java 的 String 类 型 属性 和 
VARCHAR 参数 及 结果 的 类 型 处 理 器 。 要 注意 MyBatis 不 会 宽 探 数据 库 元 信息 来 
决定 使 用 哪 种 类 型 ， 所 以 你 必须 在 参数 和 结果 映射 中 指明 那 是 VARCHAR 类 型 的 字 
段 ， 以 使 其 能 够 绑 定 到 正确 的 类 型 处 理 器 上 。 这 是 因为 ` MyBatis 直到 语句 被 执行 
才 清 楚 数 据 类 型 。 


通过 类 型 义理 器 的 泛 型 ，MyBatis 可 以 得 知 该 类 型 处 理 器 处 理 的 Java 类 型 ， 不 过 
这 种 行为 可 以 通过 两 种 方法 改变 : 


e 在 类 型 处 理 器 的 配置 元 素 (typeHandler element) 上 增加 一 个 javaType B 
性 (比如 : javaType="String" ) ; 

e 在 类 型 处 理 器 的 类 上 (TypeHandler class) 增加 一 个 @MappedTypes 注解 来 
指定 与 其 关联 的 Java 类 型 列表 。 如 果 在 javaType 属性 中 也 同时 指定 ， 则 
注解 方式 将 被 忽略 。 


可 以 通过 两 种 方式 来 指定 被 关联 的 JDBC 类 型 : 


e 在 类 型 处 理 器 的 配置 元 素 上 增加 一 个 javaType 属性 (tt 
如 : javaType="VARCHAR" ) ; 

e 在 类 型 处 理 器 的 类 上 (TypeHandler class) 增加 一 个 @MappedJdbcTypes X 
解 来 指定 与 其 关联 的 JDBC 类 型 列表 。 如 果 在 javaType 属性 中 也 同时 指 
定 ， 则 注解 方式 将 被 忽略 。 


最 后 ， 可 以 让 MyBatis 为 你 查找 类 型 义理 器 : 


<!-- mybatis-config.xml --> 
<typeHandlers> 

«package name="org.mybatis.example"/> 
</typeHandlers> 


注意 在 使 用 自动 检索 (autodiscovery) 功能 的 时 候 ， 只 能 通过 注解 方式 来 指定 
JDBC 的 类 型 。 


你 能 创建 一 个 泛 型 类 型 处 理 器 ， eR 类 。 为 达到 此 目的 ， 需要 增加 


一 个 接收 该 类 作为 参数 的 构造 器 ， 这 样 在 构造 一 个 类 MyBatis 就 会 
传 入 一 个 具体 的 类 。 


//GenericTypeHandler.java 

public class GenericTypeHandler<E extends MyObject> extends BaseTy[ 
private Class<E> type; 
public GenericTypeHandler(Class<E> type) ( 


if (type == null) throw new IllegalArgumentException("Type argl 
this.type - type; 





EnumTypeHandler 和 EnumOrdinalTypeHandler 都 是 泛 型 类 型 处 理 器 
(generic TypeHandlers) , 我 们 将 会 在 接 下 来 的 部 分 详细 探讨 。 
处 理 榴 举 类 型 


若 想 映射 枚 举 类 型 Enum ， 则 需要 从 EnumTypeHandler 或 者 
EnumordinalTypeHandler 中 选 一 个 来 使 用 。 


比如 说 我 们 想 存 储 取 近似 值 时 用 到 的 舍 入 模式 。 默 认 情 况 下 ，MyBatis 会 利用 
EnumTypeHandler 来 把 Enum 值 转换 成 对 应 的 名 字 。 


注意 EnumTypeHandler 在 某 种 意义 上 来 说 是 比较 特别 的 ， AAA 
某 个 特定 的 类 ， 而 它 不 同 ， 它 会 处 理 任意 继承 了 Enum 的 类 


不 过 ， 我 们 可 能 不 想 存 储 名 字 ， 相 反 我 们 的 DBA 会 坚持 使 用 整形 值 代 码 。 那 也 一 
样 轻而易举 : 在 配置 文件 中 把 EnumordinalTypeHandler 加 到 typeHandlers 
中 即 可 ， 这 样 每 个 RoundingMode 将 通过 他 们 的 序数 值 来 映射 成 对 应 的 整形 。 


<!-- mybatis-config.xml --> 
<typeHandlers> 

<typeHandler handler="org.apache.ibatis.type.EnumOrdinalTypeHand- 
</typeHandlers> 


‘| — B 
但 是 怎样 能 将 同样 的 Enum 既 映 射 成 字符 串 又 映射 成 整形 呢 2 


自动 映射 器 (auto-mapper) 会 自动 地 选用 EnumordinalTypeHandler 来 义理 ， 
所 以 如 果 我 们 想 用 普通 的 ”EnumTypeHandler ， 就 非 要 为 那些 SQL 语句 显 式 地 设 
转 要 用 到 的 类 型 处 理 器 不 可 。 


(下 一 节 才 开始 讲 映射 器 文件 ， 所 以 如 果 是 首次 阅读 该 文档 ， 你 可 能 需要 先 越过 这 
一 步 ， 过 会 再 来 看 。) 








<!DOCTYPE mapper 
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 


«mapper namespace="org.apache.ibatis.submitted.rounding.Mapper"> 
<resultMap type="org.apache.ibatis.submitted.rounding.User" id: 
«id column="id" property="id"/> 
<result column="name" property="name"/> 
«result column="funkyNumber" property="funkyNumber"/> 
<result column="roundingMode" property="roundingMode"/> 
</resultMap> 


<select id="getUser" resultMap="usermap"> 
select * from users 
</select> 
<insert id="insert"> 
insert into users (id, name, funkyNumber, roundingMode) va- 
#{id}, #{name}, #{funkyNumber}, #{roundingMode} 
) 


</insert> 


<resultMap type="org.apache.ibatis.submitted.rounding.User" id: 
<id column="id" property="id"/> 
<result column="name" property="name"/> 
«result column="funkyNumber" property="funkyNumber"/> 
«result column="roundingMode" property="roundingMode" typel 
</resultMap> 
<select id="getUser2" resultMap="usermap2"> 
select * from users2 
</select> 
<insert id="insert2"> 
insert into users2 (id, name, funkyNumber, roundingMode) v: 
Z(id), #{name}, #{funkyNumber}, #{roundingMode, typeHar 
) 


</insert> 


</mapper> 





对 象 工 厂 (objectFactory) 


MyBatis 每 次 创建 结果 对 象 的 新 实例 时 ， 它 都 会 使 用 一 个 对 象 工厂 

(ObjectFactory) 实例 来 完成 。 默认 的 对 象 工厂 需要 做 的 仅仅 是 实例 化 目标 类 ， 
要 么 通过 默认 构造 方法 ， 要 么 在 参数 映射 存在 的 时 候 通过 参数 构造 方法 来 实例 化 。 
如 果 想 覆盖 对 象 工厂 的 默认 行为 ， 则 可 以 通过 创建 自己 的 对 象 工厂 来 实现 。 上 比如 : 


// ExampleObjectFactory.java 
public class ExampleObjectFactory extends DefaultObjectFactory ( 
public Object create(Class type) ( 
return super.create(type); 


public Object create(Class type, List«Class» constructorArgTypes, 
return super.create(type, constructorArgTypes, constructorArgs: 


public void setProperties(Properties properties) ( 
super.setProperties(properties); 


public «T» boolean isCollection(Class<T> type) { 
return Collection.class.isAssignableFrom(type); 
1) 


| _— B 





<!-- mybatis-config.xml --> 

<objectFactory type="org.mybatis.example.Example0bjectFactory"> 
«property name="someProperty" value="100"/> 

</objectFactory> 


ObjectFactory 接口 很 简单 ， 它 包含 两 个 创建 用 的 方法 ， 一 个 是 义理 黑 认 构 造 方 法 
的 ， 另 外 一 个 是 处 理 带 参数 的 构造 方法 的 。 最 后 ，setProperties 方法 可 以 被 用 来 
配置 ObjectFactory， 在 初始 化 你 的 ObjectFactory 实例 后 ， objectFactory 元 素 体 
中 定义 的 属性 会 被 传递 给 setProperties 方法 。 


插件 (plugins) 


MyBatis 允许 你 在 已 映射 语句 执行 过 程 中 的 某 一 点 进行 拦截 调用 。 默 认 情 况 下 ， 
MyBatis 允许 使 用 插件 来 拦截 的 方法 调用 包括 : 


e Executor (update, query, flushStatements, commit, rollback, getTransaction, 
close, isClosed) 

e ParameterHandler (getParameterObject, setParameters) 

e ResultSetHandler (handleResultSets, handleOutputParameters) 

e StatementHandler (prepare, parameterize, batch, update, query) 


这 些 类 中 方法 的 细节 可 以 通过 查看 每 个 方法 的 签名 来 发 现 ， 或 者 直接 查看 MyBatis 
的 发 行 包 中 的 源 代 码 。 假设 你 想 做 的 不 仅仅 是 监控 方法 的 调用 ， 那 么 你 应 该 很 好 的 
了 解 正在 重 写 的 方法 的 行为 。 因为 如 果 在 试图 修改 或 重 写 已 有 方法 的 行为 的 时 候 ， 
你 很 可 能 在 破坏 MyBatis 的 核心 模块 。 这 些 都 是 更 低层 的 类 和 方法 ， 所 以 使 用 插件 
的 时 候 要 特别 当心 。 


通过 MyBatis 提供 的 强大 机 制 ， 使 用 插件 是 非常 简单 的 ， 只 需 实 现 Interceptor $ 
口 ， 并 指定 了 想 要 拦截 的 方法 签名 即 可 。 


// ExamplePlugin.java 
@Intercepts({@Signature( 
type= Executor.class, 
method = "update", 
args = {MappedStatement.class, Object.class})}) 
public class ExamplePlugin implements Interceptor { 
public Object intercept(Invocation invocation) throws Throwable . 
return invocation.proceed(); 


} 
public Object plugin(Object target) { 
return Plugin.wrap(target, this); 


public void setProperties(Properties properties) { 
} 
} 


二 BET 


<!-- mybatis-config.xml --> 
<plugins> 
<plugin interceptor="org.mybatis.example.ExamplePlugin"> 
<property name="someProperty" value="100"/> 
</plugin> 
</plugins> 


上 面 的 插件 将 会 拦截 在 Executor 实例 中 所 有 的 “update” 方法 调用 ， 这 里 的 
Executor 是 负责 执行 低层 映射 语句 的 内 部 对 象 。 


NOTE mii 


除了 用 插件 来 修改 MyBatis 核心 行为 之 外 ， 还 可 以 通过 完全 和 覆盖 配置 类 来 达到 目 
的 。 只 需 继 承 后 覆盖 其 中 的 每 个 方法 ， 再 把 它 传递 到 
sqlSessionFactoryBuilder.build(myConfig) 方法 即 可 。 再 次 重申 ， 这 可 能 会 严重 影 
响 MyBatis 的 行为 ， 务 请 慎之 又 慎 。 


配置 环境 (environments) 


MyBatis 可 以 配置 成 适应 多 种 环境 ， 这 种 机 制 有 助 于 将 SQL 映射 应 用 于 多 种 数据 库 

ZH, 现实 情况 下 有 多 种 理由 需要 这 么 做 。 例 如 ， 开 发 、 测 试 和 生产 环境 需要 有 不 

册 ; 或 者 共享 相同 Schema 的 多 个 生产 数据 库 ， 想 使 用 相同 的 SQL 映射 。 
多 类 似 的 用 例 。 


不 过 要 记 住 : 尽管 可 以 配置 多 个 环境 ， 每 个 SqlSessionFactory 实例 只 能 选择 其 


o 


所 以 ， 如 果 你 想 连接 两 个 数据 库 ， 就 需要 创建 两 个 SqlSessionFactory 实例 ， 每 个 
数据 库 对 应 一 个 。 而 如 果 是 三 个 数据 库 ， 就 需要 三 个 实例 ， 依 此 类 推 ， 记 起 来 很 简 
单 : 


e 每 个 数据 库 对 应 一 个 SqlSessionFactory 实例 
为 了 指定 创建 哪 种 环境 ， 只 要 将 它 作为 可 选 的 参数 传递 给 
SqlSessionFactoryBuilder 即 可 。 可 以 接受 环境 配置 的 两 个 方法 签名 是 : 


sqlSessionFactoryBuilder.build(reader, 
sqlSessionFactoryBuilder.build(reader, 


SqlSessionFactory factory 
SqlSessionFactory factory 


4] = E 








如 果 忽 略 了 环境 参数 ， 那 么 默认 环境 将 会 被 加 载 ， 如 下 所 示 : 


sq1SessionFactoryBuilder.build(reader), 
sglSessionFactoryBuilder.build(reader,[ 


SqlSessionFactory factory 
SqlSessionFactory factory 


gcc — ————— X" — ——— !——'ÀÜ' D: 


环境 元 素 定义 了 如 何 配置 环境 。 





<environments default="development"> 
<environment id="development"> 
«transactionManager type="JDBC"> 
«property name="..." value="..."/> 
</transactionManager> 
<dataSource type="POOLED"> 
«property name="driver" value="${driver}"/> 
«property name="url" value="${url}"/> 
<property name="username" value="${username}"/> 
<property name="password" value="${password}"/> 
</dataSource> 
</environment> 
</environments> 


注意 这 里 的 关键 点 : 


默认 的 环境 ID (比如 :default=”development”) 。 

每 个 environment 元 素 定义 的 环境 ID 〈 比 如 :id="development ) 。 
事务 管理 器 的 配置 (比如 :type="”JDBC”) 。 

数据 源 的 配置 (比如 :type=”"POOLED”) 。 


默认 的 环境 和 环境 ID 是 一 目 了 然 的 。 随 你 怎么 命名 ， 只 要 保证 默认 环境 要 匹配 其 
中 一 个 环境 ID。 


事务 管理 器 (transactionManager) 
在 MyBatis 中 有 两 种 类 型 的 事务 管理 器 〈 也 就 是 type="[JDBC|IMANAGED]”) 


e JDBC - 这 个 配置 就 是 直接 使 用 了 JDBC 的 提交 和 回 滚 设置 ， 它 依赖 于 从 数据 
源 得 到 的 连接 来 管理 事务 范围 。 


e MANAGED - 这 个 配置 几乎 没 做 什么 。 它 从 来 不 提交 或 回 滚 一 个 连接 ， 而 是 让 
容器 来 管理 事务 的 整个 生命 周期 (比如 JEE 应 用 服务 器 的 上 下 文 ) 。 默认 情 
况 下 它 会 关闭 连接 ， 然 而 一 些 容器 并 不 希望 这 样 ， 因 此 需要 将 
closeConnection 属性 设置 为 false 来 阻止 它 默认 的 关闭 行为 。 例 如 : 


&lt;transactionManager type="MANAGED"&gt; 
&lt;property name="closeConnection" value="false"/&gt; 
&lt;/transactionManager&gt; 


NOTE 如 果 你 正在 使 用 Spring + MyBatis， 则 没有 必要 配置 事务 管理 器 ， 因为 
Spring 模块 会 使 用 自 带 的 管理 器 来 覆盖 前 面 的 配置 。 


这 两 种 事务 管理 器 类 型 都 不 需要 任何 属性 。 它 们 不 过 是 类 型 别名 ， 换 句 话 说， 你 可 
以 使 用 TransactionFactory 接口 的 实现 类 的 完全 限定 名 或 类 型 别名 代替 它们 。 


public interface TransactionFactory { 
void setProperties(Properties props); 
Transaction newTransaction(Connection conn); 
Transaction newTransaction(DataSource dataSource, TransactionIso: 





任何 在 XML 中 配置 的 属性 在 实例 化 之 后 将 会 被 传递 给 setProperties() 方法 。 你 也 
需要 创建 一 个 Transaction 接口 的 实现 类 ， 这 个 接口 也 很 简单 : 


public interface Transaction { 
Connection getConnection() throws SQLException; 
void commit() throws SQLException; 
void rollback() throws SQLException; 
void close() throws SQLException; 


使 用 这 两 个 接口 ， 你 可 以 完全 自 定义 MyBatis 对 事务 的 处 理 。 
数据 源 (dataSource) 
dataSource 元 素 使 用 标准 的 JDBC 数据 源 接口 来 配置 JDBC 连接 对 象 的 资源 。 


。 许多 MyBatis 的 应 用 程序 将 会 按 示 例 中 的 例子 来 配置 数据 源 。 然 而 它 并 不 是 必 
须 的 。 要 知道 为 了 方便 使 用 延迟 加 载 ， 数 据 源 才 是 必须 的 。 


有 三 种 内 建 的 数据 源 类 型 (也 就 是 type="[UNPOOLED|POOLED|JNDI]”) 


UNPOOLED- 这 个 数据 源 的 实现 只 是 每 次 被 请 求 时 打开 和 关闭 连接 。 虽 然 一 点 
慢 ， 它 对 在 及 时 可 用 连接 方面 没有 性 能 要 求 的 简单 应 用 程序 是 一 个 很 好 的 选择 。 不 
同 的 数据 库 在 这 方面 表现 也 是 不 一 样 的 ， 所 以 对 某 些 数据 库 来 说 使 用 连接 池 并 不 重 
这 个 配置 也 是 理想 的 。UNPOOLED 类 型 的 数据 源 仅 仅 需要 配置 以 下 5 种 属 


e driver 一 这 是 JDBC 驱动 的 Java 类 的 完全 限定 名 〈 并 不 是 JDBC 驱 动 中 可 
能 包含 的 数据 源 类 ) 。 

e url 一 这 是 数据 库 的 JDBC URL 地 址 。 

e username 一 登录 数据 库 的 用 户 名 。 

e password 一 登录 数据 库 的 密码 。 

e defaultTransactionIsolationLevel 一 默认 的 连接 事务 隔离 级 别 。 

MA 你 也 可 以 传递 属性 给 数据 库 驱 动 。 要 这 样 做 ， 属 性 的 前 级 为 “driver.”， 

列 如 


e driver.encoding=UTF8 


这 将 通过 DriverManager.getConnection(url,driverProperties) 方 法 传递 值 为 ”UTF8 
的 encoding 属性 给 数据 库 驱 动 。 


POOLED- 这 种 数据 源 的 实现 利用 “ 池 ” 的 概念 将 JDBC 连接 对 象 组 织 起 来 ， 避 免 了 
ee 时 所 必需 的 初始 化 和 认证 时 间 。 这 是 一 种 使 得 并 发 Web 应 用 快 
速 响应 ; 青 求 的 流行 义理 方式 。 


除了 上 述 提 到 UNPOOLED 下 的 属性 外 ， 会 有 更 多 属性 用 来 配置 POOLED 的 数据 
TR : 


e poolMaximumActiveConnections -在 任意 时 间 可 以 存在 的 活动 〈 也 就 是 正 
在 使 用 ) 连接 数量 ， 默 认 值 : 10 

e poolMaximumIdleConnections 一 任意 时 间 可 能 存在 的 空 闪 连接 数 。 

e poolMaximumCheckoutTime 一 在 被 强制 返回 之 前 ， 池 中 连接 被 检 出 
(checked out) 时 间 ， 默 认 值 : 20000 38% (BN 20 秒 ) 

e WEE — 这 是 一 个 底层 设置 ， 如 果 获 取 连 接 花 费 的 相当 长 的 时 
间 ， 它 会 给 连接 池 打 印 状态 日 志 并 重新 尝试 获取 一 个 连接 (避免 在 误 配置 的 情 
况 下 一 直 安静 的 失败 ) ， 默认 值 : 20000 毫秒 (BN 20 秒 ) 。 

e poolPingQuery -发 送 到 数据 库 的 侦 测 查询 ， 用 来 检验 连接 是 否 义 在 正常 工 
作 秩 序 中 并 准备 接受 请 求 。 默 认 是 “NO PING QUERY SET”， 这 会 导致 多 数 数 
EA ee 误 消息 。 

e poolPingEnabled 一 是 否 馈 用 侦 测 查询 。 若 开启 ， 也 必须 使 用 一 个 可 执行 的 
SQL 语句 设置 SE 属性 〈 最 好 是 一 个 非常 快 的 SQL) , BCL 
值 : false。 

e poolPingConnectionsNotUsedFor 一 配置 poolPingQuery 的 使 用 频 度 。 这 
可 以 被 设置 成 匹配 具体 的 数据 库 连 接 超 时 时 间 ， 来 避免 不 必要 的 侦 测 ， 黑 认 
值 : 0〈 即 所 有 连接 每 一 时 刻 都 被 侦 测 一 当然 仅 当 poolPingEnabled 为 true 
时 适用 ) 。 


JNDI- 这 个 数据 源 的 实现 是 为 了 能 在 如 EJB 或 应 用 服务 器 这 类 容器 中 使 用 ， 容 器 
可 以 集中 或 在 外 部 配置 数据 源 ， 然后 放置 一 个 JNDI 上 下 文 的 引用 。 这 种 数据 源 配 
置 只 需要 两 个 属性 : 


e initial context — 这 个 属性 用 来 在 InitialContext 中 寻找 上 下 文 ( 即 ， 
initialContext.lookup(initial context)) 。 这 是 个 可 选 属 性 ， 如 果 忽 略 ， 那 么 
data_source 属性 将 会 直接 从 InitialContext 中 寻找 。 

e data source 一 这 是 引用 数据 源 实例 位 置 的 上 下 文 的 路 径 。 提 供 了 


initial context 配置 时 会 在 其 返回 的 上 下 文中 进行 查找 ， 没 有 提供 时 则 直接 在 
InitialContext 中 查找 。 


和 其 他 数据 源 配 置 类 似 ， 可 以 通过 添加 前 级 “env.” 直 接 把 属性 传递 给 初始 上 下 文 。 
比如 : 


e env.encoding=UTF8 


这 就 会 在 初始 上 下 文 (InitialContext) 实例 化 时 往 它 的 构造 方法 传递 值 为 UTF8 
的 encoding 属性 。 


通过 需要 实现 接口 org.apache.ibatis.datasource.DataSourceFactory , 


也 可 使 用 任何 第 三 方 数据 源 ， 


public interface DataSourceFactory { 
void setProperties(Properties props); 
DataSource getDataSource(); 


j 


org.apache.ibatis.datasource.unpooled.UnpooledDataSourceFactory 可 


被 用 作 父 类 来 构建 新 的 数据 源 适 配器 ， 上 比如 下 面 这 段 插 入 C3P0 数据 源 所 必需 的 代 
码 : 


import org.apache.ibatis.datasource.unpooled.UnpooledDataSourceFac! 
import com.mchange.v2.c3p0.ComboPooledDataSource; 


public class C3PODataSourceFactory extends UnpooledDataSourceFacto! 


public C3PODataSourceFactory() ( 
this.dataSource - new ComboPooledDataSource(); 





为 了 兮 其 工作 ， 为 每 个 需要 MyBatis AR setter 方法 中 增加 一 个 属性 。 下 面 是 一 
个 可 以 连接 至 PostgreSQL 数据 库 的 例子 


<dataSource type-"org.myproject.C3PODataSourceFactory"> 
«property name="driver" value-"org.postgresql.Driver"/» 
«property name="url" value="jdbc:postgresql:mydb"/> 
<property name="username" value="postgres"/> 
<property name="password" value="root"/> 

</dataSource> 


databaseldProvider 


MyBatis 可 以 根据 不 同 的 数据 库 厂商 执行 不 同 的 语句 ， 这 种 多 厂商 的 支持 是 基于 映 
射 语句 中 的 databaserd 属性 。 MyBatis 会 加 载 不 带 databaseId 属性 和 带 有 
匹配 当前 数据 库 databaseId 属性 的 所 有 语句 。 如 果 同 时 找到 带 有 
databaseId 和 不 带 databaseId 的 相同 语句 ， 则 后 者 会 被 舍弃 。 为 支持 多 厂 
商 特性 只 要 像 下 面 这 样 在 mybatis-config.xml 文件 中 加 入 databaseIdProvider 
即 可 : 


«databaseldProvider type="DB_VENDOR" /> 


这 里 的 DB VENDOR 会 通过 DatabaseMetaDatat#getDatabaseProductName() 
返回 的 字符 串 进 行 设 置 。 由 于 通常 情 况 下 这 个 字符 串 都 非常 长 而 且 相同 产品 的 不 同 
版 本 会 返回 不 同 的 值 ， 所 以 最 好 通过 设置 属性 别名 来 使 其 变 短 ， 如 下 : 


<databaseIdProvider type="DB_VENDOR"> 
«property name="SQL Server" value="sqlserver"/> 
«property name="DB2" value="db2"/> 
«property name-"Oracle" value="oracle" /> 
</databaseldProvider> 


在 有 properties ++, DB VENDOR databaseldProvider 的 将 被 设置 为 第 一 个 能 匹 
配 数据 库 产 品名 称 的 属性 键 对 应 的 值 ， 如 果 没 有 匹配 的 属性 将 会 设置 为 "nul"。 在 
这 个 例子 中 ， 如 果 getDatabaseProductName() 返回 “Oracle (DataDirect)", 
databaseld 将 被 设置 为 “oracle”。 


你 可 以 通过 实现 接口 org.apache.ibatis.mapping.DatabaseIdProvider 并 在 
mybatis-config.xml 中 注册 来 构建 自己 的 DatabaseldProvider : 


public interface DatabaseIdProvider ( 
void setProperties(Properties p); 
String getDatabaseld(DataSource dataSource) throws SQLException; 


AAA Bg 


映射 器 (mappers) 


MyBatis 的 行为 已 经 由 上 述 元 素 配 置 完 了 ， 我 们 现在 就 要 定义 SQL 映射 语 
。 但 是 首先 我 们 需要 告诉 MyBatis 到 哪里 去 找到 这 些 语句。 Java a o 
XAR Naples 所 以 最 佳 的 方式 是 告诉 MyBatis 到 哪里 去 找 映射 文 
件 。 你 可 以 使 用 相对 于 类 路 径 的 资源 引用 ， 或 完全 限定 资源 定位 符 (包括 
file:/// 的 URL) ， 或 类 名 和 包 名 等 。 例 如 : 


<!-- Using classpath relative resources --> 

<mappers> 
«mapper resource="org/mybatis/builder/AuthorMapper.xml"/> 
«mapper resource="org/mybatis/builder/BlogMapper . xm1"/> 
<mapper resource="org/mybatis/builder/PostMapper.xml"/> 

</mappers> 


<!-- Using url fully qualified paths --> 

<mappers> 
«mapper url="file:///var/mappers/AuthorMapper .xm1"/> 
«mapper url="file:///var/mappers/BlogMapper.xml"/> 
«mapper url="file:///var/mappers/PostMapper.xml"/> 

</mappers> 


<!-- Using mapper interface classes --> 

<mappers> 
«mapper class="org.mybatis.builder.AuthorMapper"/> 
<mapper class="org.mybatis.builder.BlogMapper"/> 
«mapper class="org.mybatis.builder.PostMapper"/> 

</mappers> 


<!-- Register all interfaces in a package as mappers --> 
<mappers> 

<package name="org.mybatis.builder"/> 
</mappers> 


这 些 配置 会 告诉 了 MyBatis 去 哪里 找 映 射 文件 ， 剩 下 的 细节 就 应 该 是 每 个 SQL ER 
射 文件 了 ， 也 就 是 接 下 来 我 们 要 讨论 的 。 


Mapper XML 文件 


MyBatis 的 真正 强大 在 于 它 的 映射 语句 ， 也 是 它 的 魔力 所 在 。 由 于 它 的 异常 强大 ， 
映射 器 的 XML 文件 就 显得 相对 简单 。 如 果 拿 它 跟 具有 相同 功能 的 JDBC 代码 进行 
对 比 ， 你 会 立即 发 现 省 掉 了 将 近 95% 的 代码 。MyBatis 就 是 针对 SQL 构建 的 ， 并 
且 比 普通 的 方法 做 的 更 好 。 


SQL 映射 文件 有 很 少 的 几 个 顶级 元 素 (按照 它们 应 该 被 定义 的 顺序 ) 


e cache 一 给 定 命名 空间 的 缓存 配置 。 

e cache-ref 一 其 他 命名 空间 缓存 配置 的 引用 。 

e resultMap 一 是 最 复杂 也 是 最 强大 的 元 素 ， 用 来 描述 如 何 从 数据 库 结果 集中 
来 加 载 对 象 。 


e ~~parameterMap~~ 
Es) bu ng x 
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e sql 一 可 被 其 他 语句 引用 的 可 重用 语句 块 。 
e insert 一 映射 插入 语句 
e update 一 映射 更 新 语句 
e delete 一 映射 删除 语句 
e select 一 上 映射 查询 语句 


下 一 部 分 将 从 语句 本 身 开 始 来 描述 每 个 元 素 的 细节 。 


select 


查询 语句 是 MyBatis 中 最 常用 的 元 素 之 一 ， 光 能 把 数据 存 到 数据 库 中 价值 并 不 大 ， 

如 果 还 能 重新 取出 来 村 有 用 ， 多 数 应 用 也 都 是 查询 比 修改 要 频繁 。 对 每 个 插入 、 更 
新 或 删除 操作 ， 通 常 对 应 多 个 查询 操作 。 这 是 MyBatis 的 基本 原则 之 一 ， 也 是 将 焦 
点 和 努力 放 到 查询 和 结果 映射 的 原因 。 简单 查询 的 select 元 素 是 非常 简单 的 。 比 

如 : 


«select id-"selectPerson" parameterType="int" resultType-"hashmap": 
SELECT * FROM PERSON WHERE ID = #{id} 

«/select» 
[amm e e cem E 
这 个 语句 被 称 作 selectPerson， 接 受 一 个 int (或 Integer) 类 型 的 参数 ， 并 返回 一 
个 HashMap 类 型 的 对 象 ， 其 中 的 键 是 列 名 ， 值 便 是 结果 行 中 的 对 应 值 。 


注意 参数 符号 : 


#{id} 


这 就 告诉 MyBatis 创建 一 个 预 处理 语 句 参 数 ， 通 过 JDBC, F E 
中 会 由 一 个 “?" 来 标识 ， 并 被 传递 到 一 个 新 的 预 处 理 语 句 中 ， 就 像 这 


// Similar JDBC code, NOT MyBatis... 

String selectPerson = "SELECT * FROM PERSON WHERE ID=?"; 
PreparedStatement ps - conn.prepareStatement(selectPerson); 
ps.setInt(1,id); 


当然 ， 这 需要 很 多 单独 的 JDBC 的 代码 来 提取 结果 并 将 它们 映射 到 对 象 实例 中 ， 这 
就 是 Ge 节省 你 时 间 的 地 方 。 我 们 需要 深入 了 解 参 数 和 结果 映射 ， 细 节 部 分 我 
们 下 面 来 了 解 。 


select 元 素 有 很 多 属性 允许 你 配置 ， 来 决定 每 条 语句 的 作用 细节 。 


<select 
id="selectPerson" 
parameterType="int" 
parameterMap="deprecated" 
resultType="hashmap" 
resultMap="personResultMap" 
flushCache="false" 
useCache="true" 
timeout="10000" 
fetchSize="256" 
statementType="PREPARED" 
resultSetType="FORWARD_ONLY"> 


Select Attributes 
属性 描述 
id 在 命名 空间 中 唯一 的 标识 符 ， 可 以 被 用 来 引用 这 条 语句 。 


将 会 传人 这 条 语句 的 参数 类 的 完全 限定 名 或 别名 。 这 个 属 
parameterType 性 是 可 选 的 ， 因 为 MyBatis 可 以 通过 TypeHandler 推断 出 
具体 传人 语句 的 参数 ， 默 认 值 为 Unset。 





parameterMap 


从 这 条 语句 中 返回 的 期 望 类 型 的 类 的 完全 限定 名 或 别名 。 
A 注意 如 果 是 集合 情形 ， 那 应 该 是 集合 可 以 包含 的 类 型 ， 而 
Reb Ei 


不 能 是 集合 本 身 。 使 用 resultType 或 resultMap， 但 不 能 
同时 使 用 。 


外 部 resultMap 的 命名 引用 。 结 果 集 的 映射 是 MyBatis 最 
强大 的 特性 ， 对 其 有 一 个 很 好 的 理解 的 话 ， 许 多 复杂 映射 
的 情形 都 能 迎 尺 而 解 。 使 用 resultMap 或 resultType， 但 
不 能 同时 使 用 。 


resultMap 


flushCache 


useCache 


timeout 


fetchSize 


statementType 


resultSetType 


databaseld 


resultOrdered 


resultSets 


将 其 设置 为 true， 任 何 时 候 只 要 语句 被 调用 ， 都 会 导致 本 
地 缓存 和 二 级 缓存 都 会 被 清空 ， 黑 认 值 false. 


将 其 设置 为 true， 将 会 导致 本 条 语句 的 结果 被 二 级 缓存 ， 
默认 值 : 对 select 元 素 为 true。 


这 个 设置 是 在 抛 出 异常 之 前 ， 了 驱动 程序 等 待 数据 库 返 回 请 
求 结果 的 秒 数 。 默 认 值 为 unset (依赖 驱动 )。 


这 是 党 试 影响 驱动 程序 每 次 批量 返回 的 结果 行 数 和 这 个 设 
置 值 相 等 。 默 认 值 为 unset (依赖 驱动 ) 。 


STATEMENT, PREPARED 或 CALLABLE 的 一 个 。 这 会 
让 MyBatis 分 别 使 用 Statement, PreparedStatement 或 
CallableStatement， 默 认 值 : PREPARED。 


FORWARD_ONLY, SCROLL_SENSITIVE 或 
SCROLL_INSENSITIVE 中 的 一 个 ， 默 认 值 为 unset (K 
MIRA) 。 


如 果 配 置 了 databaseldProvider, MyBatis 会 加 载 所 有 的 
不 带 databaseld 或 匹配 当前 databaseld 的 语句 ; ¿UR i 
或 者 不 带 的 语句 都 有 ， 则 不 带 的 会 被 忽略 。 


iT B UH ot RE select 语句 适用 : WR A true, 
MERACA SREAREKEDAS, MAME MIS 
一 个 主 结果 行 的 时 候 ， 就 不 会 发 生 有 对 前 面 结果 集 的 引用 
的 情况 。 这 就 使 得 在 获取 艇 套 的 结果 集 的 时 候 不 至 于 导致 
内 存 不 够 用 。 黑 认 值 : false o 


这 个 设置 仅 对 多 结果 集 的 情况 适用 ， 它 将 列 出 语句 执行 后 
返回 的 结果 集 并 每 个 结果 集 给 一 个 名 称 ， 名 称 是 逗号 分 隔 
的 。 


insert, update 和 delete 


数据 变更 语句 insert, update 和 delete 的 实现 非常 接近 : 


<insert 
id="insertAuthor" 
parameterType="domain.blog.Author" 
flushCache="true" 
statementType="PREPARED" 
keyProperty="" 
keyColumn="" 
useGeneratedKeys="" 
timeout="20"> 


<update 
id="updateAuthor" 
parameterType="domain.blog.Author" 
flushCache="true" 
statementType="PREPARED" 
timeout="20"> 


<delete 
id="deleteAuthor" 
parameterType="domain.blog.Author" 
flushCache="true" 
statementType="PREPARED" 
timeout="20"> 


Insert, Update 和 Delete 的 属性 


属性 
id 


parameterType 


~~parameterMap~~ 


flushCache 


timeout 


statementType 


useGeneratedKeys 


keyProperty 


keyColumn 


databaseld 


描述 
命名 空间 中 的 唯一 标识 符 ， 可 被 用 来 代表 这 条 语句 。 


将 要 传 入 语句 的 参数 的 完全 限定 类 名 或 别名 。 这 个 属 
性 是 可 选 的 ， 因 为 MyBatis 可 以 通过 TypeHandler 推 
断 出 具体 传人 语句 的 参数 ， 默 认 值 为 unset。 


> A 立 -A 
o 


将 其 设置 为 true， 任 何 时 候 只 要 语句 被 调用 ， 都 会 导 
致 本 地 缓存 和 二 级 缓存 都 会 被 清空 ， 黑 认 值 : true (xt 
应 插入 、 更 新 和 删除 语句 ) o 


这 个 设置 是 在 抛 出 异常 之 前 ， 驱 动 程序 等 待 数据 库 返 
回 请 求 结果 的 秒 数 。 默 认 值 为 unset (依赖 驱动 )。 


STATEMENT，PREPARED 或 CALLABLE 的 一 个 。 
这 会 让 MyBatis 分 别 使 用 Statement, 
PreparedStatement 或 CallableStatement， 默 认 值 : 
PREPARED。 


(4x xt insert 和 update 有 用 ) 22% MyBatis 使 用 
JDBC 的 getGeneratedKeys 方法 来 取出 由 数据 库 内 
部 生成 的 主键 (比如 : fi MySQL 和 SQL Server 这 样 
的 关系 数据 库 管 理 系统 的 自动 递增 字段 ) ， 默 认 值 : 
false。 


( 仅 对 insert 和 update 有 用 ) 唯一 标记 一 个 属性 ， 
MyBatis 会 通过 getGeneratedKeys 的 返回 值 或 者 通过 
insert 语句 的 selectKey 子 元 素 设 置 它 的 键 值 ， 默 
ik: unset 。 如 果 希 望 得 到 多 个 生成 的 列 ， 也 可 以 
是 喜 号 分 隔 的 属性 名 称 列表 。 


(4x insert 和 update 有 用 ) 通过 生成 的 键 值 设置 表 
中 的 列 名 ， 这 个 设置 仅 在 某 些 数据 库 CR 
PostgreSQL) 是 必须 的 ， 当 主键 列 不 是 表 中 的 第 一 列 
的 时 候 需 要 设置 。 如 果 希 望 得 到 多 个 生成 的 列 ， 也 可 
以 是 逗号 分 隔 的 属性 名 称 列表 。 


如 果 配 置 了 databaseldProvider，MyBatis 会 加 载 所 
有 的 不 带 databaseld 或 匹配 当前 databaseld DIS 
PI: 如 果 带 或 者 不 带 的 语句 都 有 ， 则 不 带 的 会 被 忽 
BS. 


下 面 就 是 insert，update 和 delete 语句 的 示例 : 


<insert id="insertAuthor"> 
insert into Author (id, username, password, email, bio) 
values (#{id},#{username}, #{password}, #{email},#{bio}) 
</insert> 


<update id="updateAuthor"> 
update Author set 
username = #{username}, 
password = #{password}, 
email = #{email}, 


bio = #{bio} 
where id = #{id} 
</update> 


<delete id="deleteAuthor"> 
delete from Author where id = #{id} 
</delete> 


如 前 所 述 ， 插 入 语句 的 配置 规则 更 加 丰富 ， 在 插入 语句 里 面 有 一 些 额 外 的 属性 和 子 
元 素 用 来 处 理 主键 的 生成 ， 而 且 有 多 种 生成 方式 。 


首先 ， 如 果 你 的 数据 库 支持 自动 生成 主键 的 字段 (比如 MySQL 和 SQL Server) , 
那么 你 可 以 设置 useGeneratedKeys=”true”， 然 后 再 把 keyProperty 设置 到 目标 属 
性 上 就 OK 了 。 例 如 ， 如 果 上 面 的 Author 表 已 经 对 id 使 用 了 自动 生成 的 列 类 型 ， 那 
么 语句 可 以 修改 为 : 


«insert id="insertAuthor" useGeneratedKeys="true" 
keyProperty="id"> 
insert into Author (username, password, email, bio) 
values (#{username}, #{password},#{email}, #{bio}) 
</insert> 


对 于 不 支持 自动 生成 关 型 的 数据 库 或 可 能 不 支持 自动 生成 主键 JDBC 驱动 来 说 
MyBatis 有 另外 一 种 方法 来 生成 主键 。 


这 里 有 一 个 简单 (HERE) 的 示例 ， 它 可 以 生成 一 个 随机 ID (你 最 好 不 要 这 么 
做 ， 但 这 里 展示 了 MyBatis 处 理 问 题 的 灵活 性 及 其 所 关心 的 广度 ) ` 


<insert id="insertAuthor"> 
<selectKey keyProperty="id" resultType="int" order="BEFORE"> 
select CAST(RANDOM()*1000000 as INTEGER) a from SYSIBM.SYSDUMM 
</selectKey> 
insert into Author 
(id, username, password, email,bio, favourite_section) 
values 
(#{id}, #{username}, #{password}, #{email}, #{bio}, #{favourite 
</insert> 


| — — IRR 








在 上 面 的 示例 中 ，selectKey 元 素 将 会 首先 运行 ，Author 的 id 会 被 设置 ， 然 后 插入 
语句 会 被 调用 。 这 给 你 了 一 个 和 数据 库 中 来 处 理 自动 生成 的 主键 类 似 的 行为 ， 避 免 
了 使 Java 代码 变 得 复杂 。 


selectKey 元 素描 述 如 下 : 


<selectKey 
keyProperty="id" 
resultType="int" 
order="BEFORE" 
statementType="PREPARED"> 


selectKey 的 属性 
属性 描述 


selectKey 语句 结果 应 该 被 设置 的 目标 属性 。 如 果 希 望 得 
到 多 个 生成 的 列 ， 也 可 以 是 逗号 分 隔 的 属性 名 称 列表 。 


匹配 属性 的 返回 结果 集中 的 列 名 称 。 如 果 希 望 得 到 多 个 生 
成 的 列 ， 也 可 以 是 逗号 分 隔 的 属性 名 称 列表 。 


结果 的 类 型 。MyBatis 通常 可 以 推算 出 来 ， 但 是 为 了 更 加 
确定 写 上 也 不 会 有 什么 问题 。MyBatis 允许 任何 简单 类 型 

resultType 用 作 主 键 的 类 型 ， 包 括 字 符 串 。 如 果 希 望 作用 于 多 个 生成 
的 列 ， 则 可 以 使 用 一 个 包含 期 望 属性 的 Object 或 一 个 
Mapo 


这 可 以 被 设置 为 BEFORE 或 AFTER。 如果 设置 为 
BEFORE， 那 么 它 会 首先 选择 主键 ， 设 置 keyProperty 然 

order 后 执行 插入 语句 。 如 果 设 置 为 AFTER， 那 么 先 执行 插入 
语句 ， 然 后 是 selectKey TR - 这 和 像 Oracle 的 数据 库 相 
Wh, TEATS ABBOT RES RRA RSIS. 


与 前 面相 同 ，MyBatis 支持 STATEMENT, PREPARED 
statementType 和 CALLABLE 语句 的 映射 类 型 ， 分 别 代表 
PreparedStatement 和 CallableStatement 类 型 。 


keyProperty 


keyColumn 


sql 


这 个 元 素 可 以 被 用 来 定义 可 重用 的 SQL 代码 段 ， 可 以 包含 在 其 他 语句 中 。 它 可 以 
被 静态 地 (在 加 载 参数 ) 参数 化 . 不 同 的 属性 值 通过 包含 的 实例 变化 . 比如 : 


«sql id-"userColumns"» ${alias}.id,${alias}.username, ${alias}.passv 





这 个 SQL 片段 可 以 被 包含 在 其 他 语句 中 ， 例 如 : 


<select id="selectUsers" resultType="map"> 
select 
«include refid="userColumns"><property name="alias" value="t1", 
«include refid="userColumns"><property name="alias" value="t2", 
from some_table t1 
cross join some_table t2 
</select> 


sl 
属性 值 可 以 用 于 包含 的 refid 属 性 或 者 包含 的 字句 里 面 的 属性 值 ， 例 如 : 








«sql id="sometable"> 


${prefix}Table 
</sql> 
<sql id="someinclude"> 
from 
<include refid="${include_target}"/> 
</sql> 


<select id="select" resultType="map"> 
select 
field1, field2, field3 
<include refid="someinclude"> 
<property name="prefix" value="Some"/> 
<property name="include_target" value="sometable"/> 
</include> 
</select> 


参数 (Parameters) 


前 面 的 所 有 语句 中 你 所 见 到 的 都 是 简单 参数 的 例子 ， 实 际 上 参数 是 MyBatis 非常 强 
大 的 元 素 ， 对 于 简单 的 做 法 ， 大 概 90% 的 情况 参数 都 很 少 ， 比 如 : 


<select id="selectUsers" resultType="User"> 
select id, username, password 
from users 
where id = #{id} 

</select> 


上 面 的 这 个 示例 说 明了 一 个 非常 简单 的 命名 参数 映射 。 参 数 类 型 被 设置 为 int, 
这 样 这 个 参数 就 可 以 被 设置 成 任何 内 容 。 原 生 的 类 型 或 简单 数据 类 型 (上 比如 整 型 和 
FRR) 因为 没有 相关 属性 ， 它 会 完全 用 参数 值 来 蔡 代 。 然 而 ， 如 果 传 入 一 个 复杂 
的 对 象 ， 行 为 就 会 有 一 点 不 同 了 。 上 比如 : 


<insert id="insertUser" parameterType="User"> 
insert into users (id, username, password) 
values (#{id}, #{username}, #{password}) 
</insert> 


WA User 类 型 的 参数 对 象 传递 到 了 语句 中 ，id、username 和 password 属性 将 会 
被 查找 ， 然 后 将 它们 的 值 传 入 预 处 理 语句 的 参数 中 。 


这 点 对 于 向 语句 中 传 参 是 比较 好 的 而 且 又 简单 ， 不 过 参数 映射 的 功能 远 不 止 于 此 。 
首先 ， 像 MyBatis 的 其 他 部 分 一 样 ， 参 数 也 可 以 指定 一 个 特殊 的 数据 类 型 。 


#{property, javaType=int, jdbcType=NUMERIC} 


像 MyBatis 的 剩余 部 分 一 样 ，javaType 通常 可 以 从 参数 对 象 中 来 去 确定 ， 前 提 是 只 
要 对 象 不 是 一 个 HashMap。 那 么 javaType 应 该 被 确定 来 保证 使 用 正确 类 型 处 理 
器 。 


NOTE 如 果 null 被 当 作 值 来 传递 ， 对 于 所 有 可 能 为 空 的 列 ，JDBC Type 是 需 

的 。 你 可 以 自己 通过 阅读 预 处 理 语句 的 setNull() 方法 的 JavaDocs 文档 来 研究 这 种 
情况 。 

为 了 以 后 定制 类 型 处 理 方式 ， 你 也 可 以 指定 一 个 特殊 的 类 型 处 理 器 类 (或 别名 ) ， 
比如 : 


#{age, JavaType=int,jdbcType=NUMERIC, typeHandler=MyTypeHand1ler } 


REUETEKBUIB d CHECKS, Doc tg, 
对 于 数值 类 型 ， 还 有 一 个 小 数 保留 位 数 的 设置 ， 来 确定 小 数 点 后 保留 的 位 数 。 


#{height, javaType=double, jdbcType=NUMERIC, numericScale=2} 


SE, mode 属性 允许 你 指定 IN, OUT xi INOUT 参数 。 如 果 参 数 为 OUT 或 
INOUT， 参 数 对 象 属性 的 真实 值 将 会 被 改变 ， 就 像 你 在 获取 输出 参数 时 所 期 望 的 那 
样 。 如 果 mode 为 OUT (或 INOUT) ， 而 且 jdbcType 为 CURSOR( 也 就 是 
Oracle 的 REFCURSOR)， 你 必须 指定 一 个 resultMap 来 映射 结果 集 到 参数 类 型 。 
要 注意 这 里 的 javaType 属性 是 可 选 的 ， 如 果 左 边 的 空白 是 jdbcType 的 CURSOR 
类 型 ， 它 会 自动 地 被 设置 为 结果 集 。 


#{department, mode=0UT, jdbcType=CURSOR, javaType=ResultSet, result 


Ji EET 








MyBatis 也 支持 很 多 高 级 的 数据 类 型 ， 比 如 结构 体 ， 但 是 当 注 册 out 参数 时 你 必须 
告诉 它 语 句 类 型 名 称 。 上 比如 (再 次 提示 ， 在 实际 中 要 像 这 样 不 能 换行 ) 


#{middleInitial, mode=0UT, jdbcType=STRUCT, jdbcTypeName=MY_TYPE, 1 


尽管 所 有 这 些 强大 的 选项 很 多 时 候 你 只 简单 指定 属性 名 ， 其 他 的 事情 MyBatis 会 自 
己 去 推断 ， 最 多 你 需要 为 可 能 为 空 的 列 名 指定 jdbcType o 









#{firstName} 
#{middleInitial, jdbcType=VARCHAR} 
#{lastName} 
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默认 情况 下 ,使 用 #(} 格 式 的 语法 会 导致 MyBatis 创建 预 处 理 语句 属性 并 安全 地 设置 
值 ( 比 如?) 。 这 样 做 更 安全 ， 更 迅速 ， 通 常 也 是 首选 做 法 ， 不 过 有 时 你 只 是 想 直 
接 在 SQL 语句 中 插入 一 个 不 改变 的 字符 串 。 比 如 ， 像 ORDER BY， 你 可 以 这 样 来 
使 用 : 


ORDER BY ${columnName} 


这 里 MyBatis 不 会 修改 或 转 义 字符 串 。 


NOTE 以 这 种 方式 接受 从 用 户 输出 的 内 容 并 提供 给 语句 中 不 变 的 字符 串 是 不 安全 
的 ， 会 导致 潜在 的 SQL 注入 攻击 ， 因 此 要 么 不 允许 用 户 输入 这 些 字段 ， 要 么 自行 
转 义 并 检验 。 


Result Maps 


resultMap 元 素 是 MyBatis 中 最 重要 最 强大 的 元 素 。 它 就 是 让 你 远离 90% 的 需要 从 
结果 集中 取出 数据 的 JDBC 代码 的 那个 东西 , 而 且 在 一 些 情形 下 人 允许 你 做 一 些 
JDBC 不 支持 的 事 情 。 BLL 编写 相似 于 对 复杂 语句 联合 映射 这 些 等 同 的 代码 ， 
也 许可 以 跨 过 上 后 行 的 代码 。 ResultMap 的 设计 就 是 简单 语句 不 需要 明确 的 结果 映 
射 ,而 很 多 复杂 语句 确实 需要 描述 它们 的 关系 。 


你 已 经 看 到 简单 映射 语句 的 示例 了 ,但 没有 明确 的 resultMap。 比 如 : 


<select id="selectUsers" resultType="map"> 
select id, username, hashedPassword 
from some_table 
where id = #{id} 

</select> 


这 样 一 个 语句 简单 作用 于 所 有 列 被 自动 映射 到 HashMap 的 键 上 ,这 由 resultType BR 
性 指定 。 这 在 很 多 情况 下 是 有 用 的 ,但 是 HashMap 不 能 很 好 描述 一 个 领域 模型 。 那 
样 你 的 应 用 程序 将 会 使 用 JavaBeans 或 POJOs(Plain Old Java Objects, 普 通 Java 
对 象 ) 来 作为 领域 模型 。MyBatis 对 两 者 都 支持 。 看 看 下 面 这 个 JavaBean: 


package com.someapp.model; 
public class User { 
private int id; 
private String username; 
private String hashedPassword; 


public int getId() ( 
return id; 


public void setId(int id) { 
this.id - id; 


j 
public String getUsername() ( 
return username; 


public void setUsername(String username) { 
this.username - username; 


} 
public String getHashedPassword() { 
return hashedPassword; 


public void setHashedPassword(String hashedPassword) { 
this.hashedPassword - hashedPassword; 
y 
} 


基于 JavaBean 的 规范 ,上 面 这 个 类 有 3 个 属性 :id,username 和 hashedPassword。 
这 些 在 select 语句 中 会 精确 匹配 到 列 名 。 


这 样 的 一 个 JavaBean 可 以 被 映射 到 结果 集 ,就 像 映射 到 HashMap 一 样 简单 。 


<select id="selectUsers" resultType="com.someapp.model.User"> 
select id, username, hashedPassword 
from some_table 
where id = #{id} 

</select> 


要 记 住 类 型 别名 是 你 的 伙伴 。 使 用 它们 你 可 以 不 用 输入 类 的 全 路 径 。 比 如 : 


<!-- In mybatis-config.xml file --> 
<typeAlias type="com.someapp.model.User" alias="User"/> 


<!-- In SQL Mapping XML file --> 

«select id-"selectUsers" resultType="User"> 
select id, username, hashedPassword 
from some table 
where id = #{id} 

</select> 


这 些 情况 下 ,MyBatis 会 在 幕后 自动 创建 一 个 ResultMap, 基 于 属性 名 来 映射 列 到 
JavaBean 的 属性 上 。 如 果 列 名 没有 精确 匹配 ,你 可 以 在 列 名 上 使 用 select 字句 的 别 
名 (一 个 基本 的 SQL 特性 ) 来 匹配 标签 。 比 如 : 


<select id="selectUsers" resultType="User"> 


select 
user_id as E 
user_name as "userName", 
hashed_password as "hashedPassword" 


from some_table 
where id = #{id} 
</select> 


ResultMap 最 优秀 的 地 方 你 已 经 了 解 了 很 多 了 ,但 是 你 还 没有 真正 的 看 到 一 个 。 这 些 
简 单 的 示例 不 需要 上 比 你 看 到 的 更 多 东西 。 只 是 出 于 示例 的 原因 ， 六 我 们 来 看 者 最 后 
一 个 示例 中 外 部 的 resultMap 是 什么 样子 的 ,这 也 是 解决 列 名 不 匹配 的 另外 一 种 方 
式 。 


<resultMap id="userResultMap" type="User"> 
<id property="id" column="user_id" /> 
<result property="username" column="user_name"/> 
«result property="password" column="hashed_password"/> 
</resultMap> 


引用 它 的 语句 使 用 resultMap 属性 就 行 了 (注意 我 们 去 掉 了 resultType 属性 )。 比 如 : 


<select id="selectUsers" resultMap="userResultMap"> 
select user_id, user_name, hashed_password 
from some_table 
where id = #{id} 

</select> 


如 果 世 界 总 是 这 么 简单 就 好 了 。 


MyBatis 创建 的 一 个 想法 :数据 库 不 用 永远 是 你 想 要 的 或 需要 它们 是 什么 样 的 。 而 我 
们 最 喜欢 的 数据 库 最 好 是 第 三 范式 或 BCNF 模式 ， BE 们 有 时 不 是 。 如 果 可 和 有 有 
个 单独 的 数据 库 映 射 , 所 有 应 用 程序 都 可 以 使 用 它 ,这 是 非常 好 的 ,但 有 时 也 不 是 。 结 
tare MM 


比如 ,我 们 如 何 映射 下 面 这 个 语句 ? 


<!-- Very Complex Statement --> 
<select id="selectBlogDetails" resultMap="detailedBlogResultMap"> 
select 


.id as blog id, 

.title as blog title, 

.author id as blog author id, 

.id as author id, 

username as author username, 

.password as author password, 

email as author email, 

bio as author bio, 

.favourite section as author favourite section, 

id as post id, 

blog id as post blog id, 

.author id as post author id, 

Created on as post created on, 

.Section as post section, 

.subject as post subject, 

.draft as draft, 

.body as post body, 

.id as comment id, 

.post id as comment post id, 

.hame as comment name, 

.comment as comment text, 

.id as tag id, 

.hame as tag name 

from Blog B 
left outer join Author A on B.author id - A.id 
left outer join Post P on B.id - P.blog id 
left outer join Comment C on P.id - C.post id 
left outer join Post Tag PT on PT.post id - P.id 
left outer join Tag T on PT.tag id - T.id 
where B.id = #{id} 
</select> 


[E AA AAA i 


你 可 能 想 把 它 映射 到 一 个 智能 的 对 象 模型 ,包含 一 个 作者 写 的 博客 ,有 很 多 的 博文 ,每 
篇 博文 有 规 条 或 多 条 的 评论 和 标签 。 下 面 是 一 个 完整 的 复杂 结果 映射 例子 (假设 作 
者 , 博客 , 博文 , 评论 和 标签 都 是 类 型 的 别名 ) 我 们 来 看 看 , 。 但 是 不 用 紧张 , 我 们 会 
一 步 一 步 来 说 明 。 当天 最 初 它 看 起 来 合 人 生 景 ,但 实际 上 非常 简单 。 


3300000 UUUDUU0UUU>>>>>>U00Uu 


<!-- Very Complex Result Map --> 
<resultMap id="detailedBlogResultMap" type="Blog"> 
<constructor> 
<idArg column="blog_id" javaType="int"/> 
</constructor> 
<result property="title" column="blog_title"/> 
<association property="author" javaType="Author"> 
«id property="id" column="author_id"/> 
<result property="username" column="author_username"/> 
<result property="password" column="author_password"/> 
<result property="email" column="author_email"/> 
«result property="bio" column="author_bio"/> 
«result property="favouriteSection" column="author_favourite_se 
</association> 
<collection property="posts" ofType="Post"> 
«id property="id" column="post_id"/> 
<result property="subject" column="post_subject"/> 
<association property="author" javaType="Author"/> 
<collection property="comments" ofType="Comment"> 
«id property="id" column="comment_id"/> 
</collection> 
<collection property="tags" ofType="Tag" > 
<id property="id" column="tag_id"/> 
</collection> 
<discriminator javaType="int" column="draft"> 
<case value="1" resultType="DraftPost"/> 
</discriminator> 
</collection> 
</resultMap> 
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resultMap 元 素 有 很 多 子 元 素 和 一 个 值得 讨论 的 结构 。 下 面 是 resultMap 元 素 的 概 
念 视 图 





resultMap 


e constructor - 类 在 实例 化 时 ,用 来 注入 结果 到 构造 方法 中 
o idArg -ID 参数 ;标记 结果 作为 ID 可 以 帮助 提高 整体 效能 
o arg -注入 到 构造 方法 的 一 个 普通 结果 
id -一 个 ID 结果 ;标记 结果 作为 ID 可 以 帮助 提高 整体 效能 
result 一 注入 到 字段 或 JavaBean 属性 的 普通 结果 
association 一 一 个 复杂 的 类 型 关联 ;许多 结果 将 包 成 这 种 类 型 
o RIERA - 结果 映射 自身 的 关联 ,或 者 参考 一 个 

e collection 一 复杂 类 型 的 集 
o 嵌入 结果 映射 — 结果 映射 自身 的 集 ,或 者 参考 一 个 

e discriminator 一 使 用 结果 值 来 决定 使 用 哪个 结果 映射 
o case 一 基于 某 些 值 的 结果 映射 

m BRAGLIRBRÉI— 这 种 情形 结果 也 映射 它 本 身 ,因此 可 以 包含 很 多 相 A 


的 元 素 ,或 者 它 可 以 参照 一 个 外 部 的 结果 映射 。 
ResultMap Attributes 


Attribute Description 


id A unique identifier in this namespace that can be used to 
reference this result map. 


A fully qualified Java class name, or a type alias (see the 


t 
ME table above for the list of built-in type aliases). 


If present, MyBatis will enable or disable the automapping 
autoMapping for this ResultMap. This attribute overrides the global 
autoMappingBehavior. Default: unset. 


最 佳 实践 通常 逐步 建立 结果 映射 。 单 元 测试 的 真正 帮助 在 这 里 。 如 果 你 党 试 创建 
一 次 创建 一 个 向 上 面 示例 那样 的 巨大 的 结果 映射 , 那么 可 能 会 有 错误 而 且 很 难 去 控 
制 它 来 工作 。 开 始 简单 一 些 ,一 步 一 步 的 发 展 。 而 且 要 进行 单元 测试 ! 使 用 该 框架 的 
缺点 是 它们 有 时 是 黑 盒 (是 否 可 见 源 代码 ) 。 你 确定 你 实现 想 要 的 行为 的 最 好 选择 是 
编写 单元 测试 。 它 也 可 以 你 帮助 得 到 提交 时 的 错误 。 


下 面 一 部 分 将 详细 说 明 每 个 元 素 。 
id & result 


«id property="id" column="post_id"/> 
<result property="subject" column="post_subject"/> 


这 些 是 结果 映射 最 基本 内 容 。id 和 result 都 映射 一 个 单独 列 的 值 到 简单 数据 类 型 ( 字 
符 串 , 整 型 , 双 精 度 浮 点 数 ,日 期 等 ) 的 单独 属性 或 字段 。 


两 者 之 间 的 唯一 不 同 是 id 表示 的 结果 将 是 当 比 较 对 象 实例 时 用 到 的 标识 属性 。 这 
5 助 来 改进 整体 表现 ,特别 是 缓存 和 族人 结果 映射 (也 就 是 联合 映射 ) 。 


个 都 有 一 些 属 性 : 
Id and Result Attributes 


E 


SI 


属性 


property 


column 


javaType 


jdbcType 


typeHandler 


描述 


映射 到 列 结果 的 字段 或 属性 。 如 果 匹 配 的 是 存在 的 ,和 给 定名 
称 相同 的 JavaBeans 的 属性 ,那么 就 会 使 用 。 否 则 MyBatis 
将 会 寻找 给 定名 称 property 的 字段 。 这 两 种 情形 你 可 以 使 用 
通常 点 式 的 复杂 属性 导航 。 上 比如 ,你 可 以 这 样 映射 一 些 东 西 : 
“username” ,或 者 映射 到 一 些 复杂 的 东西 : 


"address.street.number" 。 


从 数据 库 中 得 到 的 列 名 ,或 者 是 列 名 的 重 命 名 标签 。 这 也 是 通 
常 和 会 传递 给 resultSet.getString(columnName) 方 法 参数 中 
相同 的 字符 串 。 


一 个 Java 类 的 完全 限定 名 ,或 一 个 类 型 别名 (参考 上 面 内 建 类 
型 别名 的 列表 ) 。 如 果 你 映射 到 一 个 JavaBean,MyBatis 通 
常 可 以 断定 类 型 。 然而 ,如 果 你 映射 到 的 是 HashMap, 那 么 你 
应 该 明确 地 指定 javaType 来 保证 所 需 的 行为 。 


在 这 个 表格 之 后 的 所 支持 的 JDBC 类 型 列表 中 的 类 型 。 
JDBC 类 型 是 仅 人 名 需要 对 插入 ， 更 新 和 删除 操作 可 能 为 空 的 
列 进行 处 理 。 这 是 JDBC jdbcType 的 需要 ， me MyBatis 
的 。 如 果 你 直接 使 用 JDBC 编程 ,你 需要 指定 这 个 类 型 -但 仅 
仅 对 可 能 为 空 的 值 。 


我 们 在 前 面 讨 论 过 默认 的 类 型 处 理 器 。 使 用 这 个 属性 ,你 可 以 
BER 认 的 类 型 处 理 器 。 这 个 属性 值 是 类 的 完全 限定 名 或 者 
是 一 个 类 型 处 理 器 的 实现 ,或 者 是 类 型 别名 。 


支持 的 JDBC 类 型 
为 了 未 来 的 参考 ,MyBatis 通过 包含 的 jdbcType MAH SH FMM JDBC 类 型 。 


BIT FLOAT CHAR TIMESTAMP OTHER 
TINYINT REAL VARCHAR BINARY BLOG 
SMALLINT DOUBLE LONGVARCHAR VARBINARY CLOB 
INTEGER NUMERIC DATE LONGVARBINARY BOOLEAN 
BIGINT DECIMAL TIME NULL CURSOR 
s 3 

构造 方法 
<constructor> 


<idArg column="id" javaType="int"/> 
<arg column="username" javaType="String"/> 


</constructor> 


对 于 大 多 数 数 据 传输 对 象 (Data Transfer Object,DTO) 类 型 ,属性 可 以 起 作用 ,而 且 像 
你 绝 大 多 数 的 领域 模型 , 指令 也 许 是 你 想 使 用 一 成 不 变 的 类 的 地 方 。 通常 包含 引用 
或 查询 数 据 的 表 很 少 或 基本 不 变 的 话 对 一 成 不 变 的 类 来 说 是 合适 的 。 构造 方法 注 
入 允许 你 在 初始 化 时 为 类 设置 属性 的 值 ,而 不 用 暴露 出 公有 方法 。MyBatis 也 支持 私 
有 属性 和 私有 JavaBeans 属 性 来 达到 这 个 目的 ,但 是 一 些 人 更 青睐 构造 方法 注入 。 
构造 方法 元 素 支 持 这 个 。 


看 看 下 面 这 个 构造 方法 : 


public class User { 
le ore 
public User(int id, String username) { 
AR 


j 
Vile: 


} 


为 了 向 这 个 构造 方法 中 注入 结果 ,MyBatis 需要 通过 它 的 参数 的 类 型 来 标识 构造 方 
ik, Java 没有 自 查 (反射 ) 参 数 名 的 方法 。 所 以 当 创建 一 个 构造 方法 元 素 时 ,保证 参 
数 是 按 顺序 排列 的 ,而 且 数 据 类 型 也 是 确定 的 。 


<constructor> 

<idArg column="id" javaType="int"/> 

<arg column="username" javaType="String"/> 
</constructor> 


剩余 的 属性 和 规则 和 固定 的 id 和 result 元 素 是 相同 的 。 


属性 


column 


javaType 


jdbcType 


typeHandler 


select 


resultMap 


天 联 


描述 


来 自 数据 库 的 类 名 ,或 重 命名 的 列 标 签 。 这 和 通常 传递 给 
resultSet.getString(columnName) 方 法 的 字符 串 是 相同 的 。 


一 个 Java 类 的 完全 限定 名 ,或 一 个 类 型 别名 (参考 上 面 内 建 类 
型 别名 的 列表 )。 如 果 你 映射 到 一 个 JavaBean,MyBatis 通 
常 可 以 断定 类 型 。 然 而 ,如 果 你 映射 到 的 是 HashMap, 那 么 你 
应 该 明确 地 指定 javaType 来 保证 所 需 的 行为 。 


在 这 个 表格 之 前 的 所 支持 的 JDBC 类 型 列表 中 的 类 型 。 
JDBC 类 型 是 仅仅 需要 对 插入 ， ärm a 除 操作 可 能 为 空 的 
列 进行 处 理 。 这 是 JDBC 的 需要 ， jdbcType r H g MyBatis 
的 。 如 果 你 直接 使 用 JDBC 编程 ,你 需要 指定 类 型 -但 仅 
仅 对 可 能 关 空 的 值 。 


我 们 在 前 面 讨 论 过 默认 的 类 型 处 理 器 。 使 用 这 个 属性 ,你 可 以 
覆盖 默认 的 类 型 处 理 器 。 这 个 属性 值 是 类 的 完全 限定 名 或 
者 是 一 个 类 型 处 理 器 的 实现 , 或 者 是 类 型 别名 。 


The ID of another mapped statement that will load the 
complex type required by this property mapping. The 
values retrieved from columns specified in the column 
attribute will be passed to the target select statement as 
parameters. See the Association element for more. 


This is the ID of a ResultMap that can map the nested 
results of this argument into an appropriate object graph. 
This is an alternative to using a call to another select 
statement. It allows you to join multiple tables together into 
a single ResultSet .Sucha ResultSet will contain 
duplicated, repeating groups of data that needs to be 
decomposed and mapped properly to a nested object 
graph. To facilitate this, MyBatis lets you "chain" result 
maps together, to deal with the nested results. See the 
Association element below for more. 


«association property="author" column-"blog author id" javaType="Al 
«id property="id" column="author_id"/> 
<result property="username" column="author_username"/> 


</association> 


= eg 





关联 元 素 处 理 有 一 个 "类 型 的 关系 。 比 如 ,在 我 们 的 示例 中 ， 一 个 博客 有 一 个 用 户 。 
关联 映射 就 工作 于 这 种 结果 之 上 。 你 指定 了 目标 属性 ,来 获取 值 的 列 ,属性 的 java 类 
型 (很 多 情况 下 MyBatis 可 以 自己 算出 来 ) ,如 果 需 要 的 话 还 有 jdbc XH MRM 


盖 或 获取 的 结果 值 还 需要 类 型 控制 器 。 
关联 中 不 同 的 是 你 需要 告诉 MyBatis 如 何 加 载 关 联 。MyBatis 在 这 方面 会 有 两 种 不 


同 的 方式 : 


e RES AJA AT BAT SQL 映射 语句 来 返回 预期 的 复杂 类 型 。 
e 岩 套 结果 :使 用 岩 套 结果 映射 来 处 理 重 复 的 联合 结果 的 子 集 。 首 先 , 然 让 我 们 来 
查看 这 个 元 素 的 属性 。 所 有 的 你 都 会 看 到 , 它 和 普通 的 只 由 select 和 


resultMap 属性 的 结果 映射 不 同 。 


属性 


property 


javaType 


jdbcType 


typeHandler 
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描述 


映射 到 列 结 果 的 字段 或 属性 。 如 果 匹 配 的 是 存在 的 ,和 给 定名 
称 相同 的 property JavaBeans 的 属性 , 那么 就 会 使 用 。 否则 
MyBatis 将 会 寻找 给 定名 称 的 字段 。 这 两 种 情形 你 可 以 使 用 
通常 点 式 的 复杂 属性 导航 。 上 比如 ,你 可 以 这 样 映射 一 些 东 西 
:“ username ”, 或 者 映射 到 一 些 复杂 的 东西 : 
“address.street.number” 。 


一 个 Java 类 的 完全 限定 名 ,或 一 个 类 型 别名 (参考 上 面 内 建 类 
型 别名 的 列 表 ) 。 如 果 你 映射 到 一 个 JavaBean,MyBatis 通 
常 可 以 断定 类 型 。 然 而 ,如 javaType 果 你 映射 到 的 是 
HashMap, 那 么 你 应 该 明确 地 指定 javaType 来 保证 所 需 的 行 


在 这 个 表格 之 前 的 所 支持 的 JDBC 类 型 列表 中 的 类 型 。 
JDBC 类 型 是 仅仅 需要 对 插入 , 更 新 和 删除 操作 可 能 为 空 的 
列 进行 处 理 。 这 是 JDBC 的 需要 , jdbcType 而 不 是 MyBatis 
的 。 如 果 你 直接 使 用 JDBC 编程 ,你 需要 指定 这 个 类 型 -但 仅 
仅 对 可 能 为 空 的 值 。 

我 们 在 前 面 讨 论 过 默认 的 类 型 处 理 器 。 使 用 这 个 属性 ,你 可 以 
覆盖 默认 的 typeHandler 类 型 处 理 器 。 这 个 属性 值 是 类 的 完 
全 限定 名 或 者 是 一 个 类 型 处 理 器 的 实现 , 或 者 是 类 型 别名 。 


属性 描述 


来 自 数据 库 的 类 名 ,或 重 命名 的 列 标签 。 这 和 通常 传递 给 
resultSet.getString(columnName) 方 法 的 字符 串 是 相同 的 。 
column 注意 :要 处 理 复 合 主 键 ,你 可 以 指定 多 个 列 名 
通过 column= ” {prop1=col1,prop2=col2} ”这 种 语法 来 传递 给 
RESH 句 。 这 会 引起 prop1 和 prop2 以 参数 对 象形 式 来 
设置 给 目标 谋 套 查询 语句 。 


另外 一 个 映射 语句 的 ID, 可 以 加 载 这 个 属性 映射 需要 的 复 杀 类 
型 。 获 取 的 在 列 属性 中 指定 的 列 的 值 将 被 传递 给 目标 select 语 
句 作为 参数 。 表 格 后 面 有 一 个 详细 的 示例 。 select 注意 :要 
select 处 理 复 合 主 键 ,你 可 以 指定 多 个 列 名 通过 column=” 
{prop1=col1,prop2=col2} ”这 种 语法 来 传递 给 评 套 查询 语 句 。 
这 会 引起 prop1 和 prop2 以 参数 对 象形 式 来 设置 给 目标 艇 套 查 
询 语 句 。 
Optional. Valid values are lazy and eager . If present, it 


fetchType supersedes the global configuration parameter 
lazyLoadingEnabled for this mapping. 


column 


示例 : 


<resultMap id="blogResult" type="Blog"> 
«association property="author" column="author_id" javaType="Auth« 
</resultMap> 


<select id="selectBlog" resultMap="blogResult"> 
SELECT * FROM BLOG WHERE ID = #{id} 
</select> 


<select id="selectAuthor" resultType="Author"> 
SELECT * FROM AUTHOR WHERE ID = #{id} 
</select> 


E AAA 


我 们 有 两 个 查询 语句 :一 个 来 加 载 博客 ,另外 一 个 来 加 载 作 者 ,而 且 博 客 的 结果 映射 描 
述 了 "selectAuthor 语 句 应 该 被 用 来 加 载 它 的 author 属性 。 


其 他 所 有 的 属性 将 会 被 自动 加 载 ,假设 它们 的 列 和 属性 名 相 匹配 。 


这 种 方式 很 简单 , 但 是 对 于 大 型 数据 集合 和 列表 将 不 会 表现 很 好 。 问题 就 是 我 们 熟 
知 的 “N+1 查询 问题 "。 概 括 地 讲 ,N+1 查询 问题 可 以 是 这 样 引起 的 : 


e 你 执行 了 一 个 单独 的 SQL 语句 来 获取 结果 列表 (就 是 +1”)。 
e 对 返回 的 每 条 记录 ,你 执行 了 一 个 查询 语句 来 为 每 个 加 载 细 节 ( 就 是 “N”)。 


这 个 问题 会 导致 成 百 上 千 的 SQL 语句 被 执行 。 这 通常 不 是 期 望 的 。 





MyBatis 能 延迟 加 载 这 样 的 查询 就 是 一 个 好 处 ,因此 你 可 以 分 散 这 些 语句 同时 运行 的 
消 耗 。 然 而 ,如 果 你 加 载 一 个 列表 ,之 后 迅速 迭代 来 访问 馈 套 的 数据 ,你 会 调用 所 有 的 
GER R, X EB 25 RE eh 


所 以 还 有 另外 一 种 方法 。 
KKM ES E 


属性 描述 


这 是 结果 映射 的 1D, 可 以 映射 关联 的 艇 套 结 果 到 一 个 合适 

的 对 象 图 中 。 这 是 一 种 替代 方法 来 调用 另外 一 个 查询 语 

句 。 这 人 允许 你 联合 多 个 表 来 合成 到 resultMap 一 个 单独 的 
resultMap 结果 集 。 这 样 的 结果 集 可 能 包含 重复 ,数据 的 重复 组 需要 被 

分 解 ,合理 映射 到 一 个 和 储 套 的 对 象 图 。 为 了 使 它 变 得 容 

易 ,MyBatis 让 你 “ 链 接 " 结 果 了 映射 ,来 处 理 柑 套 结 果 。 一 个 例 

子 会 很 容易 来 仿照 ,这 个 表格 后 面 也 有 一 个 示例 。 


When joining multiple tables, you would have to use 
column alias to avoid duplicated column names in the 

columnPrefix ResultSet. Specifying columnPrefix allows you to map 
such columns to an external resultMap. Please see the 
example explained later in this section. 


By default a child object is created only if at least one of 
the columns mapped to the child's properties is non null. 
With this attribute you can change this behaviour by 

notNullColumn specifiying which columns must have a value so MyBatis 
will create a child object only if any of those columns is 
not null. Multiple column names can be specified using a 
comma as a separator. Default value: unset. 


If present, MyBatis will enable or disable auto-mapping 
when mapping the result to this property. This attribute 
overrides the global autoMappingBehavior. Note that it 
has no effect on an external resultMap, so it is pointless 
to use it with select or resultMap attribute. Default 
value: unset. 


autoMapping 


在 上 面 你 已 经 看 到 了 一 个 非常 复 条 的 找 套 关联 的 示例 。 下 面 这 个 是 一 个 非常 简单 的 
示例 来 说 明 它 如 何 工作 。 代 蔡 了 执行 一 个 分 离 的 语句 ,我 们 联合 博客 表 和 作者 表 在 
一 起 ,就 像 : 


<select id="selectBlog" resultMap="blogResult"> 


select 
B.id as blog_id, 
B.title as blog_title, 
B.author_id as blog_author_id, 
A.id as author_id, 
A.username as author_username, 
A.password as author_password, 
A.email as author_email, 
A.bio as author_bio 


from Blog B left outer join Author A on B.author_id = A.id 
where B.id = #{id} 
</select> 


注意 这 个 联合 查询 , 以 及 采取 保护 来 确保 所 有 结果 被 唯一 而 且 清 晰 的 名 字 来 重 命 
名 。 这 使 得 映射 非常 简单 。 现 在 我 们 可 以 映射 这 个 结果 : 


<resultMap id="blogResult" type="Blog"> 

<id property="id" column="blog_id" /> 

<result property="title" column="blog_title"/> 

<association property="author" column="blog_author_id" javaType=' 
</resultMap> 


<resultMap id="authorResult" type="Author"> 
«id property="id" column="author_id"/> 
<result property="username" column="author_username"/> 
«result property="password" column="author_password"/> 
<result property="email" column="author_email"/> 
<result property="bio" column="author_bio"/> 
</resultMap> 


¡NAAA E 


在 上 而 的 示例 中 你 可 以 看 到 博客 的 作者 关联 代表 着 authorResult ARE I 
实例 。 


FFER ERER Akh id 元 素 扮演 了 非常 重要 的 角色 。 应 应 该 通常 指定 一 
个 或 多 个 属性 ,它们 可 以 用 来 唯一 标识 结果 。 实 际 上 就 是 如 果 你 离开 她 了 ,但 是 有 一 
个 严重 的 性 能 问题 时 MyBatis 仍然 可 以 工作 。 选 择 的 属性 越 少 越 好 ,它们 可 以 唯一 
地 标识 结果 。 主 键 就 是 一 个 显而易见 的 选择 (尽管 是 联合 主键 )。 


现在 ,上 面 的 示例 用 了 外 部 的 结果 映射 元 素来 映射 关联 。 这 使 得 Author 结果 映射 可 
以 重用。 然而 ,如 果 你 不 需要 重用 它 的 话 ,或 者 你 仅仅 引用 你 所 有 的 结果 映射 合 到 一 
个 单独 描 述 的 结果 映射 中 。 你 可 以 谋 套 结果 映射 。 这 里 给 出 使 用 这 种 方式 的 相同 示 
例 : 





<resultMap id="blogResult" type="Blog"> 
<id property="id" column="blog_id" /> 
«result property="title" column="blog_title"/> 
<association property="author" javaType="Author"> 
«id property="id" column="author_id"/> 
<result property="username" column="author_username"/> 
<result property="password" column="author_password"/> 
<result property="email" column="author_email"/> 
<result property="bio" column="author_bio"/> 
</association> 
</resultMap> 


What if the blog has a co-author? The select statement would look like: 


«select id-"selectBlog" resultMap="blogResult"> 


select 
B.id as blog id, 
B.title as blog title, 
A.id as author id, 
A.username as author username, 
A.password as author password, 
A.email as author email, 
A.bio as author bio, 
CA.id as co author id, 
CA.username as co author username, 
CA.password as co author password, 
CA.email as co author email, 
CA.bio as co author bio 

from Blog B 


left outer join Author A on B.author id - A.id 
left outer join Author CA on B.co author id - CA.id 
where B.id = #{id} 

«/select» 


Recall that the resultMap for Author is defined as follows. 


«resultMap id="authorResult" type="Author"> 
<id property="id" column="author_id"/> 
<result property="username" column="author_username"/> 
«result property="password" column="author_password"/> 
<result property="email" column="author_email"/> 
<result property="bio" column="author_bio"/> 
</resultMap> 


Because the column names in the results differ from the columns defined in the 
resultMap, you need to specify columnPrefix to reuse the resultMap for 
mapping co-author results. 


<resultMap id="blogResult" type="Blog"> 
<id property="id" column="blog_id" /> 
«result property="title" column="blog_title"/> 
<association property="author" 
resultMap="authorResult" /> 
<association property="coAuthor" 
resultMap="authorResult" 
columnPrefix="co_" /> 
</resultMap> 


上 面 你 已 经 看 到 了 如 何 处 理 有 一 个 "类 型 关联 。 但 是 “有 很 多 个 "是 怎样 的 ?下 面 这 个 
部 分 就 是 来 讨论 这 个 主题 的 。 


集合 


«collection property="posts" ofType="domain.blog.Post"> 
<id property="id" column="post_id"/> 
<result property="subject" column="post_subject"/> 
<result property="body" column="post_body"/> 
</collection> 


合 元 素 的 作用 几乎 和 关联 是 相同 的 。 实 际 上 ,它们 也 很 相似 ,文档 的 异同 是 多 余 
的 。 所 以 我 们 更 多 关注 于 它们 的 不 同 。 


我 们 来 继续 上 面 的 示例 ,一 个 博客 只 有 一 个 作者 。 但 是 博客 有 很 多 文章 。 在 博客 类 
中 , 这 可 以 由 下 面 这 样 的 写法 来 表示 : 


private List<Post> posts; 


SARAH EE EA RARO List 中 ,我 们 使 用 集合 元 素 。 就 像 关 联 元 素 一 样 ,我 们 可 以 从 
EE 


ROQUES 15 
首先 ,让 我 们 看 看 使 用 谋 套 查询 来 为 博客 加 载 文 章 。 


<resultMap id="blogResult" type="Blog"> 
«collection property="posts" javaType="ArrayList" column="id" of” 
</resultMap> 


<select id="selectBlog" resultMap="blogResult"> 
SELECT * FROM BLOG WHERE ID = #{id} 
</select> 


<select id="selectPostsForBlog" resultType="Blog"> 
SELECT * FROM POST WHERE BLOG ID = #{id} 
«/select» 


4 == 


这 里 你 应 该 注意 很 首先 ,你 

应 该 注意 我 们 使 用 的 是 集合 元 素 。 然 后 要 注意 那个 新 的 “ofType” 属 性 。 这 个 属性 用 
来 区 分 JavaBean( 或 字段 ) 属 性 类 的 类 型 来 说 是 很 重要 的 。 所 以 你 可 以 
读 出 下 面 这 个 映射 : 








«collection property="posts" javaType="ArrayList" column="id" ofTy; 





ie VE: “在 Post 类 型 的 ArrayList 中 的 posts 的 集合 。” 
an 属性 是 不 需要 的 ,因为 MyBatis 在 很 多 情况 下 会 为 你 算出 来 。 所 以 你 可 以 
缩短 Bik 


«collection property="posts" column="id" ofType="Post" select="sele 


al us E 


RAIRE? 


至 此 ,你 可 以 猜测 集合 的 伐 套 结果 是 如 何 来 工作 的 ,因为 它 和 关联 完全 相同 ,除了 它 应 
用 了 一 个 “ofType" 属 性 


First, let's look at the SQL: 





<select id="selectBlog" resultMap="blogResult"> 
select 
B.id as blog_id, 

.title as blog title, 

.author id as blog author id, 

.id as post id, 

.subject as post subject, 
P.body as post body, 
from Blog B 
left outer join Post P on B.id - P.blog id 
where B.id = #{id} 

</select> 


"00 D D 


我 们 又 一 次 联合 了 博客 表 和 文章 表 , 而 且 关 注 于 保证 特性 ,结果 列 标签 的 简单 映射 。 
现 在 用 文章 映射 集合 映射 博客 ,可 以 简单 写 为 : 


<resultMap id="blogResult" type="Blog"> 
<id property="id" column="blog_id" /> 
«result property="title" column="blog_title"/> 
<collection property="posts" ofType="Post"> 
«id property="id" column="post_id"/> 
<result property="subject" column="post_subject"/> 
«result property="body" column="post_body"/> 
</collection> 
</resultMap> 


同样 ,要 记得 id 元 素 的 重要 性 ,如 果 你 不 记得 了 ,请 阅读 上 面 的 关联 部 分 。 


同样 , 如 果 你 引用 更 长 的 形式 允许 你 的 结果 映射 的 更 多 重用 , 你 可 以 使 用 下 面 这 个 蔡 
代 的 映射 : 


<resultMap id="blogResult" type="Blog"> 

<id property="id" column="blog_id" /> 

<result property="title" column="blog_title"/> 

«collection property="posts" ofType="Post" resultMap="blogPostRe: 
</resultMap> 


<resultMap id="blogPostResult" type="Post"> 
«id property="id" column="id"/> 
«result property="subject" column="Subject"/> 
«result property="body" column="body"/> 
</resultMap> 
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注意 这 个 对 你 所 映射 的 内 容 没 有 深度 ,广度 或 关联 和 集合 相 联 合 的 限制 。 当 映射 它 
们 时 你 应 该 在 大 脑 中 保留 它们 的 表现 ， 你 的 应 用 在 找到 最 佳 方法 前 要 一 直 进 行 的 
单元 测 | 试 和 性 8 Em] ix. 好 在 myBatis 让 你 后 来 可 以 改变 想法 ， 而 不 对 你 的 代码 造成 
很 小 (或 任何 ) 影 响 。 





高 级 关联 和 集合 映射 是 一 个 深度 的 主题 。 文 档 只 能 给 你 介绍 到 这 了 。 加 上 一 点 联系 ， 
你 会 很 快 清楚 它们 的 用 法 。 


ES 


<discriminator javaType="int" column="draft"> 
<case value="1" resultType="DraftPost"/> 
</discriminator> 


有 时 一 个 单独 的 数据 库 查 询 也 许 返 回 很 多 不 同 (但 是 希望 有 些 关 联 ) 数据 类 型 的 结果 
Ro 鉴别 器 元 素 就 是 被 设计 来 处 理 这 个 情况 的 , 还 有 包括 类 的 继承 层次 结构 。 鉴别 
器 非常 容易 理 解 ,因为 它 的 表现 很 像 Java 语言 中 的 switch i$ 9, 


定义 鉴别 器 指定 了 column 和 javaType 属性 。 列 是 MyBatis 查找 比较 值 的 地 方 。 
JavaType 是 需要 被 用 来 保证 等 价 测试 的 合适 类 型 (尽管 字符 串 在 很 多 情形 下 都 会 有 
用 )。 比 如 : 


<resultMap id="vehicleResult" type="Vehicle"> 
<id property="id" column="id" /> 
«result property="vin" column="vin"/> 
«result property="year" column="year"/> 
«result property="make" column="make"/> 
«result property="model" column="model"/> 
«result property="color" column="color"/> 
<discriminator javaType="int" column="vehicle_type"> 
<case value="1" resultMap="carResult"/> 
«case value="2" resultMap="truckResult"/> 
«case value="3" resultMap="vanResult"/> 
«case value="4" resultMap="SuvResult"/> 
</discriminator> 
</resultMap> 


在 这 个 示例 中 , MyBatis 会 从 结果 集中 得 到 每 条 记录 , 然后 比较 它 的 vehicle 类 型 的 
值 。 如 果 它 匹配 任何 一 个 鉴别 器 的 实例 ,那么 就 使 用 这 个 实例 指定 的 结果 映射 。 换 
句 话说 ,这 样 做 完全 是 剩余 的 结果 映射 被 忽略 (除非 它 被 扩展 ,这 在 第 二 个 示例 中 讨 
论 ) 。 如 果 没 有 任何 一 个 实例 相 匹 配 ,那么 MyBatis 仅仅 使 用 鉴别 器 块 外 定义 的 结果 
上 映射。 所 以 ,如 果 carResult 按 如 下 声明 : 


<resultMap id="carResult" type="Car"> 
«result property="doorCount" column="door_count" /> 
</resultMap> 


那么 只 有 doorCount 属性 会 被 加 载 。 这 步 完 成 后 完整 地 允许 鉴别 器 实例 的 独立 组 ， 
尽管 和 父 结果 映射 可 能 没有 什么 关系 。 这 种 情况 下 ,我 们 当然 知道 cars 和 vehicles 
之 间 有 关系 , 如 Car 是 一 个 Vehicle 实例 。 因 此 ,我 们 想 要 剩余 的 属性 也 被 加 载 。 我 
们 设置 的 结果 映射 的 简单 改变 如 下 。 


<resultMap id="carResult" type="Car" extends="vehicleResult"> 
<result property="doorCount" column="door_count" /> 
</resultMap> 


现在 vehicleResult 和 carResult 的 属性 都 会 被 加 载 了 。 


尽管 佛经 有 些 人 会 发 现 这 个 外 部 映射 定义 会 多 少 有 一 些 令 人 厌烦 之 处 。 因此 还 有 另 
外 一 种 语法 来 做 简洁 的 映射 风格 。 比 如 : 


<resultMap id="vehicleResult" type="Vehicle"> 
<id property="id" column="id" /> 
<result property="vin" column="vin"/> 
«result property="year" column="year"/> 
«result property="make" column="make"/> 
«result property="model" column="model"/> 
«result property="color" column="color"/> 
<discriminator javaType="int" column="vehicle_type"> 
<case value="1" resultType="carResult"> 
<result property="doorCount" column="door_count" /> 
</case> 
<case value="2" resultType="truckResult"> 
«result property="boxSize" column="box_size" /> 
<result property="extendedCab" column="extended_cab" /> 
</case> 
<case value="3" resultType="vanResult"> 
«result property="powerSlidingDoor" column-z"power sliding do 
</case> 
<case value="4" resultType="suvResult"> 
«result property-"allwheelDrive" column-"all wheel drive" /> 
</case> 
</discriminator> 
</resultMap> 


4 ees 


要 记得 这 些 都 是 结果 映射 , 如 果 你 不 指定 任何 结果 , 那么 MyBatis 将 会 为 你 自动 匹 
配 列 和 属性 。 所 以 这 些 例子 中 的 大 部 分 是 很 元 长 的 ,而 其 实 是 不 需要 的 。 也 就 是 说 ， 
很 多 数据 库 是 很 复杂 的 ,我 们 不 太 可 能 对 所 有 示例 都 能 依靠 它 。 


自动 映射 


正如 你 在 前 面 一 节 看 到 的 ， 在 简单 的 场景 下 ，MyBatis 可 以 蔡 你 自动 映射 查询 结 
Ro 如 果 遇 到 复 条 的 场景 ， 你 需要 构建 一 个 result map. 但 是 在 本 节 你 将 看 到 ， 你 
也 可 以 混合 使 用 这 两 种 策略 。 让 我 们 到 深 一 点 的 层面 上 看 看 自动 映射 是 怎样 工作 
的 。 


当 自动 映射 查询 结果 时 ，MyBatis 会 获取 sql 返 回 的 列 名 并 在 java 类 中 查找 相同 名 字 
的 属性 (忽略 大 小 写 ) 。 这 意味 着 如 果 Mybatis 发 现 了 /D 列 和 /jo 属 性 ，Mybatis 会 
IDEN (& 18,25 id. 





通常 数据 库 列 使 用 大 写 单词 命名 ， 单 词 间 用 下 划 线 分 隔 ; 而 java 属 性 一 般 遵 循 驼 峰 
命名 法 。 为 了 在 这 两 种 命名 方式 之 间 启 用 自动 陕 射 ， 需 要 将 


mapUnderscoreToCamelCase 设置 为 true。 


自动 映射 甚至 在 特定 的 result map 下 也 能 工作 。 在 这 种 情况 下 ， 对 于 每 一 个 result 

map, 所 有 的 ResultSet 提 供 的 列 ， 如 果 没 有 被 手工 映射 ， 则 将 被 自动 上 映射。 自动 映 
射 处 理 完毕 后 手工 映射 地 会 被 处 理 。 在 接 下 来 的 例子 中 ， id 和 userName 列 将 被 
自动 映射 ， hasheq_password 列 将 根据 配置 映射 。 


<select id="selectUsers" resultMap="userResultMap"> 


select 
user_id as Id 
user_name as "userName", 


hashed_password 
from some_table 
where id = #{id} 
</select> 


<resultMap id="userResultMap" type="User"> 


«result property="password" column="hashed_password"/> 
</resultMap> 


There are three auto-mapping levels: 


e NONE - disables auto-mapping. Only manually mapped properties will be 
set. 

e PARTIAL - will auto-map results except those that have nested result 
mappings defined inside (joins). 

e FULL -auto-maps everything. 


The default value is PARTIAL , and itis so for a reason. When FULL is used 
auto-mapping will be performed when processing join results and joins retrieve 
data of several different entities in the same row hence this may result in 
undesired mappings. To understand the risk have a look at the following sample: 


<select id="selectBlog" resultMap="blogResult"> 
select 
B.id, 
B title: 
A.username, 
from Blog B left outer join Author A on B.author_id = A.id 
where B.id = #{id} 
</select> 


<resultMap id="blogResult" type="Blog"> 
<association property="author" resultMap="authorResult"/> 
</resultMap> 


<resultMap id="authorResult" type="Author"> 
<result property="username" column="author_username"/> 
</resultMap> 


With this result map both Blog and Author will be auto-mapped. But note that 
Author has an id property and there is a column named id in the ResultSet so 
Author's id will be filled with Blog's id, and that is not what you were expecting. So 
use the FULL option with caution. 


Regardless of the auto-mapping level configured you can enable or disable the 
automapping for an specific ResultMap by adding the attribute autoMapping to 
it: 


«resultMap id="userResultMap" type="User" autoMapping="false"> 
«result property="password" column="hashed_password"/> 
</resultMap> 


缓存 


MyBatis 包含 一 个 非常 强大 的 查询 缓存 特性 , 它 可 以 非常 方便 地 配置 和 定制 。 
MyBatis 3 中 的 缓存 实现 的 很 多 改进 都 已 经 实现 了 ,使 得 它 更 加 强大 而 且 易 于 配置 。 


默认 情况 下 是 没有 开 书 缓存 的 ,除了 局 部 的 session 缓存 ,可 以 增强 变现 而 且 义 理 循 
环 依赖 也 是 必须 的 。 要 开启 二 级 缓存 ,你 需要 在 你 的 SQL 映射 文件 中 添加 一 行 : 


<cache/> 


字面 上 看 就 是 这 样 。 这 个 简单 语句 的 效果 如 下 : 


映射 语句 文件 中 的 所 有 select 语句 将 会 被 缓存 。 

映射 语句 文件 中 的 所 有 insert,update 和 delete 语句 会 刷新 缓存 。 
缓存 会 使 用 Least Recently Used(LRU, 最 近 最 少 使 用 的 ) 算 法 来 收回 。 

pens 间 表 (比如 no Flush Interval, ki Mill Ar ja] Bra), 缓存 不 会 以 任何 时 间 顺 序 
来 刷新 。 

缓存 会 存储 列表 集合 或 对 象 (无 论 查询 方法 返回 什么 ) 的 1024 个 引用 。 
缓存 会 被 视 为 是 read/write( 可 读 / 可 写 ) 的 缓存 ,意味 着 对 象 检索 不 是 共享 的 ,而 
且 可 以 安全 地 被 调用 者 修改 ,而 不 干扰 其 他 调用 者 或 线程 所 做 的 潜在 修改 。 


所 有 的 这 些 属性 都 可 以 通过 缓存 元 素 的 属性 来 修改 。 比 如 : 


<Cache 
eviction="FIFO" 
flushInterval="60000" 
size="512" 
readOnly="true"/> 


这 个 更 高 级 的 配置 创建 了 一 个 FIFO 缓存 ,并 每 隔 60 秒 刷新 , 存 数 结果 对 象 或 列表 的 
512 个 引用 ,而 且 返 回 的 对 象 被 认为 是 只 读 的 ,因此 在 不 同 线程 中 的 调用 者 之 间 修 改 
它们 会 导致 冲突 。 


可 用 的 收回 策略 有 : 


LRU — 最近 最 少 使 用 的 : 移 除 最 长 时 间 不 被 使 用 的 对 象 。 

FIFO 一 先进 先 出 : 按 对 象 进 入 缓存 的 顺序 来 移 除 它 们 。 

SOFT 一 软 引 用 : 移 除 基 于 垃圾 回收 器 状态 和 软 引 用 规则 的 对 象 。 

WEAK — 弱 引 用 :更 积极 地 移 除 基于 垃圾 收集 器 状态 和 弱 引 用 规则 的 对 象 。 


默认 的 是 LRU。 


flushlnterval( 刷 新 闻 隔 ) 可 以 被 设置 为 任意 的 正 整数 ,而 且 它们 代表 一 个 合理 的 毫秒 
形式 的 时 间 段 。 默 认 情 况 是 不 设置 ,也 就 是 没有 刷新 闻 陋 ,缓存 仅仅 调用 语句 时 刷 


o 


size( 引 用 数目 ) 可 以 被 设置 为 任意 正 整 数 ,要 记 住 你 缓存 的 对 象 数目 和 你 运行 环境 的 
可 用 内 存 资 源 数目 。 默 认 值 是 1024。 


readOnly( 只 读 ) 属 性 可 以 被 设置 为 true 或 false。 只 读 的 缓存 会 给 所 有 调用 者 返回 缓 
存 对 象 的 相同 实例 。 因 此 这 些 对 象 不 能 被 修改 。 这 提供 了 很 重要 的 性 能 优势 。 可 读 
写 的 缓存 会 返回 缓存 对 象 的 拷贝 (通过 序列 化 ) 。 这 会 慢 一 些 ,但 是 安全 ,因此 默认 是 

false。 


使 用 自 定 义 缓存 


除了 这 些 自 定义 缓存 的 方式 , 你 也 可 以 通过 实现 你 自己 的 缓存 或 为 其 他 第 三 方 缓存 
方案 创建 适配器 来 完全 履 盖 缓存 行为 。 


«cache type="com.domain.something.MyCustomCache"/> 


这 个 示 BUE 示 了 如 何 使 用 一 个 自 定义 BUE 存 实 HL. type R 性 指 定 的 类 必须 
实现 org.mybatis.cache.Cache 接口 。 这 个 接口 是 MyBatis 框架 中 很 多 复杂 的 接口 
之 一 ,但 是 简单 给 定 它 做 什么 就 行 。 


public interface Cache ( 
String getId(); 
int getSize(); 
void putObject(Object key, Object value); 
Object getObject(Object key); 
boolean hasKey(Object key); 
Object removeObject(Object key); 
void clear(); 


要 配置 你 的 缓存 , 简单 和 公有 的 JavaBeans 属性 来 配置 你 的 缓存 实现 , 而 且 是 通过 
cache 元 素来 传递 属性 , 比如 , 下 面 代 码 会 在 你 的 缓存 实现 中 调用 一 个 称 为 
"setCacheFile(String flle)” 的 方法 : 


<cache type="com.domain.something.MyCustomCache"> 
<property name="cacheFile" value="/tmp/my-custom-cache.tmp"/> 
</cache> 


你 可 以 使 用 所 有 简单 类 型 作为 JavaBeans 的 属性 ,MyBatis 会 进行 转换 。 


记得 缓存 配置 和 缓存 实例 是 绑 定 在 SQL 映射 文件 的 命名 空间 是 很 重要 的 。 因 此 ,所 
有 在 相同 命名 空间 的 语句 正如 绑 定 的 缓存 一 样 。 语句 可 以 修改 和 缓存 交互 的 方式 ， 
或 在 语句 的 语句 的 基础 上 使 用 两 种 简单 的 属性 来 完全 排除 它们 。 默 认 情 况 下 ,语句 
可 以 这 样 来 配置 : 


«select ... flushCache="false" useCache="true"/> 
«insert ... flushCache="true"/> 
«update ... flushCache="true"/> 
«delete ... flushCache="true"/> 


因为 那些 是 默认 的 ,你 明显 不 能 明确 地 以 这 种 方式 来 配置 一 条 语句 。 相 反 , 如 果 你 想 
改 变 默 认 的 行为 ,只 能 设置 flushCache 和 useCache 属性 。 比 如 ,在 一 些 情况 下 你 
也 许 想 排除 从 缓存 中 查询 特定 语句 结果 ,或 者 你 也 许 想 要 一 个 查询 语句 来 刷新 缓 
存 。 相 似 地 ,你 也 许 有 一 些 更 新 语句 依靠 执行 而 不 需要 刷新 缓存 。 


回想 一 下 上 一 节 内 容 , 这 个 特殊 命名 空间 的 唯一 缓存 会 被 使 用 或 者 刷新 相同 命名 空 
间 内 的 语句 。 也 许 将 来 的 某 个 时 候 , 你 会 想 在 命名 空间 中 共享 相同 的 缓存 配置 和 实 
例 。 在 这 样 的 情况 下 你 可 以 使 用 cache-ref 元 素来 引用 另外 一 个 缓存 。 


«cache-ref namespace="com.someone.application.data.SomeMapper"/> 


动态 SQL 


MyBatis 的 强大 特性 之 一 便 是 它 的 动态 SQL。 如 果 你 有 使 用 JDBC 或 其 他 类 似 框架 
的 经 验 ， 你 就 能 体会 到 根据 不 同 条 件 拼接 SQL 语句 有 多 么 痛苦 。 拼 接 的 时 候 要 确 
保 不 能 志 了 必要 的 空格 ， 还 要 注意 省 掉 列 名 列表 最 后 的 逗号 。 利 用 动态 SQL 这 一 
特性 可 以 彻底 摆脱 这 种 痛苦 。 


通常 使 用 动态 SQL 不 可 能 是 独立 的 一 部 分 ,MyBatis 当然 使 用 一 种 强大 的 动态 SQL 
语言 来 改进 这 种 情形 ,这 种 语言 可 以 被 用 在 任意 的 SQL 映射 语句 中 。 


动态 SQL 元 素 和 使 用 JSTL 或 其 他 类 似 基于 XML 的 文本 义理 器 相似 。 在 MyBatis 

之 前 的 版 本 中 ,有 很 多 的 元 素 需 要 来 了 解 。MyBatis 3 大 大 提升 了 它们 ,现在 用 不 到 原 
先 一 半 的 元 素 就 可 以 了 。MyBatis 采用 功能 强大 的 基于 OGNL 的 表达 式 来 消除 其 他 
元 素 。 

if 

choose (when, otherwise) 


trim (where, set) 
foreach 


if 
动态 SQL 通常 要 做 的 事情 是 有 条 件 地 包含 where 子 句 的 一 部 分 。 比 如 : 


«select id="findActiveBlogwithTitleLike" 
resultType="Blog"> 
SELECT * FROM BLOG 
WHERE state = “ACTIVE” 
«if test="title != null"> 
AND title like #{title} 
</if> 
</select> 


这 条 语句 提供 了 一 个 可 选 的 文本 查找 类 型 的 功能 。 如 果 没 有 传 入 “title”， 那 么 所 有 处 
于 “ACTIVE” 状 态 的 BLOG 都 会 返回 ; 反之 若 传 入 了 “title”， 那 么 就 会 把 模糊 查 

找 “title” 内 容 的 BLOG 结 果 返 回 〈 就 这 个 例子 而 言 ， 细 心 的 读者 会 发 现 其 中 的 参数 值 
是 可 以 包含 一 些 掩 码 或 通配符 的 ) 。 


如 果 想 可 选 地 通过 “title" 和 “author 两 个 条 件 搜 索 该 怎么 办 呢 ? 首先 ， 改 变 语句 的 名 
称 让 它 更 具 实 际 意义 ; 然后 只 要 加 入 另 一 个 条 件 即 可 。 


<select id="findActiveBlogLike" 
resultType="Blog"> 
SELECT * FROM BLOG WHERE state = ‘ACTIVE’ 
«if test="title != null"> 
AND title like #{title} 


</if> 
<if test="author != null and author.name != null"> 
AND author_name like #{author.name} 
</if> 
</select> 


choose, when, otherwise 


有 些 时 候 ， 我 们 不 想 用 到 所 有 的 条 件 语句 ， 而 只 想 从 中 择 其 一 二 。 针 对 这 种 情况 ， 
MyBatis 提供 了 choose 元 素 ， 它 有 点 像 Java 中 的 switch 语句 。 


还 是 上 面 的 例子 ， 但 是 这 次 变 为 提供 了 “title" 就 按 'title" 查 找 ， 提 供 了 “author 就 
按 “author" 查 找 ， 若 两 者 都 没有 提供 ， 就 返回 所 有 符合 条 件 的 BLOG (实际 情况 可 能 
是 由 管理 员 按 一 定 策略 选 出 BLOG 列表 ， 而 不 是 返回 大 量 无 意义 的 随机 结果 ) 。 


<select id="findActiveBlogLike" 
resultType="Blog"> 
SELECT * FROM BLOG WHERE state = ‘ACTIVE’ 
«choose» 
«when test="title !- null"> 
AND title like #{title} 
</when> 
«when test="author != null and author.name != null"> 
AND author_name like #{author.name} 
</when> 
<otherwise> 
AND featured = 1 
</otherwise> 
</choose> 
</select> 


trim, where, set 


前 面 几 个 例子 已 经 合宜 地 解决 了 一 个 臭名 昭著 的 动态 SQL 问题 。 现 在 考虑 回 
BP Gl, BOR BAT ACTIVE = 1” 也 设置 成 动态 的 条 件 ， 看 看 会 发 生 什么 。 


<select id="findActiveBlogLike" 
resultType="Blog"> 
SELECT * FROM BLOG 


WHERE 

«if test="state != null"> 
state = #{state} 

</if> 


«if test="title != null"> 
AND title like #{title} 


</if> 
«if test="author != null and author.name != null"> 
AND author name like #{author.name} 
</if> 
</select> 


如 果 这 些 条 件 没有 一 个 能 匹配 上 将 会 怎样 ?最 终 这 条 SQL 会 变 成 这 样 : 


SELECT * FROM BLOG 
WHERE 


这 会 导致 查询 失败 。 如 果 仅 仅 第 二 个 条 件 匹 配 又 会 怎样 ?3 这 


AR 
Wa 
O 
e 
m 
Yb 
Fi 
Bi 
EZ 


SELECT * FROM BLOG 
WHERE 
AND title like ‘someTitle’ 


这 个 查询 也 会 失败 。 这 个 问题 不 能 简单 的 用 条 件 句 式 来 解决 ， 如 果 你 也 便 经 被 迫 这 
样 写 过， 那么 你 很 可 能 从 此 以 后 都 不 想 再 这 样 去 写 了 。 


MyBatis 有 一 个 简单 的 处 理 ， 这 在 90% 的 情况 下 都 会 有 用 。 而 在 不 能 使 用 的 地 方 ， 
你 可 以 自 定义 处 理 方 式 来 合 其 正常 工作 。 一 处 简单 的 修改 就 能 得 到 想 要 的 效果 : 


<select id="findActiveBlogLike" 
resultType="Blog"> 
SELECT * FROM BLOG 


<where> 
«if test="state !- null"> 
state = #{state} 
</if> 


<if test="title != null"> 
AND title like #{title} 
</if> 
<if test="author != null and author.name != null"> 
AND author_name like #{author.name} 
</if> 
</where> 
</select> 


where 元 素 知 道 只 有 在 一 个 以 上 的 if 条 件 有 值 的 情况 下 才 去 插入 “WHERE” 子 句 。 而 
且 ， 若 最 后 的 内 容 是 “AND” 或 “OR” 开 头 的 ，where 元 素 也 知道 如 何 将 他 们 去 除 。 


如 果 where 元 素 没有 按 正常 套路 出 牌 ， 我 们 还 是 可 以 通过 自 定义 trim 元 素来 定制 
我 们 想 要 的 功能 。 上 比如 ， 和 where 元 素 等 价 的 自 定义 trim 元 素 为 : 

<trim prefix="WHERE" prefixOverrides="AND |OR "> 

</trim> 
E 


的 ) 。 它 带 来 的 结果 就 是 所 有 在 prefixOverrides 属性 中 指定 的 内 容 将 被 移 除 ， 并 且 
EN prefix 属性 中 指定 的 内 容 。 


类 似 的 用 于 动态 更 新 语句 的 解决 方案 叫做 set。set 元 素 可 以 被 用 于 动态 包含 需要 更 
新 的 列 ， 而 舍 去 其 他 的 。 上 比如 : 


«update id="updateAuthorIfNecessary"> 
update Author 


<set> 
«if test="username !- null">username=#{username}, </if> 
«if test="password != null">password=#{password},</if> 
«if test="email != null">email=#{email},</if> 
«if test="bio != null">bio=#{bio}</if> 

</set> 

where id=#{id} 
</update> 


这 里 ， set 元 素 会 动态 前 置 SET 关键 字 ， 同 时 也 会 消除 无 关 的 逗号 ， 因 为 用 了 条 件 
语句 之 后 很 可 能 就 会 在 生成 的 赋值 语句 的 后 面 留 下 这 些 豆 号 。 


若 你 对 等 价 的 自 定义 trim 元 素 的 样子 感 兴趣 ， 那 这 就 应 该 是 它 的 真面目 : 


«trim prefix="SET" suffixOverrides=","> 


</trim> 
注意 这 里 我 们 忽略 的 是 后 级 中 的 值 ， 而 又 一 次 附加 了 前 级 中 的 什 。 


foreach 


动态 SQL 的 另外 一 个 常用 的 必要 操作 是 需要 对 一 个 集合 进行 通 历 ， 通 常 是 在 构建 
IN 条 件 语句 的 时 候 。 上 比如 : 


«select id-"selectPostIn" resultType="domain.blog.Post"> 
SELECT * 
FROM POST P 
WHERE ID in 
«foreach item="item" index="index" collection="list" 
open="(" separator="," close=")"> 
#{item} 
</foreach> 
</select> 


foreach 元 素 的 功能 是 非常 强大 的 ， 它 允许 你 指定 一 个 集合 ， 声 明 可 以 用 在 元 素 体 
内 的 集合 项 和 索引 变量 。 它 也 人 允许 你 指定 开 闭 匹配 的 字符 串 以 及 在 迭代 中 间 放 置 分 
隔 符 。 这 个 元 素 是 很 智能 的 ， 因 此 它 不 会 偶然 地 附加 多 余 的 分 隔 符 。 


注意 你 可 以 将 一 个 List 实例 或 者 数组 作为 参数 对 象 传 给 MyBatis， 当 你 这 么 做 的 时 
候 ，MyBatis 会 自动 将 它 包装 E Map 中 并 以 名 称 为 键 。 List 实例 将 会 以 “list” 作 
为 键 ， 而 数组 实例 的 键 将 是 “array”。 


到 此 我 们 已 经 完成 了 涉及 XML 配置 文件 和 XML 映射 文件 的 讨论 。 下 一 部 分 将 详细 
探讨 Java API， 这 样 才能 从 已 创建 的 映射 中 获取 最 大 利益 。 

bind 

bind 元 素 可 以 从 OGNL 表达 式 中 创建 一 个 变量 并 将 其 绑 定 到 上 下 文 。 比 如 : 


<select id="selectBlogsLike" resultType="Blog"> 
«bind name="pattern" value="'%' + _parameter.getTitle() + '%'" /: 
SELECT * FROM BLOG 
WHERE title LIKE #{pattern} 

</select> 





Multi-db vendor support 


一 个 配置 了 “databaseld"” 变 量 的 databaseldProvider 对 于 动态 代码 来 说 是 可 用 的 ， 
这 样 就 可 以 根据 不 同 的 数据 库 厂 商 构 建 特定 的 语句 。 比 如 下 面 的 例子 : 


<insert id="insert"> 
<selectKey keyProperty="id" resultType="int" order="BEFORE"> 


<if test="_databaseld == 'oracle'"> 
select seq users.nextval from dual 
</if> 
<if test="_databaseld == 'db2'"> 
select nextval for seg users from sysibm.sysdummy1" 
</if> 
</selectKey> 
insert into users values (#{id}, #{name}) 
«/insert» 


动态 SQL 中 可 插 拔 的 脚本 语言 


MyBatis 从 3.2 开始 支持 可 插 拔 的 脚本 i 因此 你 可 以 在 插入 一 种 语言 的 驱动 
(language driver) 之 后 来 写 基 于 这 种 i 的 动态 态 SQL 查询 。 


可 以 通过 实现 下 面 接口 的 方式 来 插入 一 种 语言 : 


public interface LanguageDriver { 
ParameterHandler createParameterHandler(MappedStatement mappedSt: 
SqlSource createSqlSource(Configuration configuration, XNode scr: 
SqlSource createSqlSource(Configuration configuration, String sci! 





一 旦 有 了 自 定 义 的 语言 驱动 ， 你 就 可 以 在 mybatis-config.xml 文件 中 将 它 设置 为 默 
gS 


<typeAliases> 

<typeAlias type="org.sample.MyLanguageDriver" alias="myLanguage", 
</typeAliases> 
<settings> 

<setting name="defaultScriptingLanguage" value="myLanguage"/> 
</settings> 
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除了 设置 默认 语言， 你 也 可 以 针对 特殊 的 语句 指定 特定 语言 ， 这 可 以 通过 如 下 的 
lang 属性 来 完成 : 


<select id="selectBlog" lang="myLanguage"> 
SELECT * FROM BLOG 
</select> 


或 者 在 你 正在 使 用 的 映射 中 加 上 注解 @Lang 来 完成 : 


public interface Mapper { 
QLang(MyLanguageDriver.class) 
QSelect("SELECT * FROM BLOG") 
List«Blog» selectBlog(); 

} 


注意 可 以 将 Apache Velocity 作为 动态 语言 来 使 用 ， 更 多 细节 请 参考 MyBatis- 
Velocity 项 目 。 

你 前 面 看 到 的 所 有 xml 标签 都 是 默认 MyBatis 语言 提供 的 ， 它 是 由 别名 为 “xml 
语言 驱动 器 org.apache.ibatis.scripting.xmltags.XmlLanguageDriver Jk 
动 的 。 


Java API 


既然 你 已 经 知道 如 何 配置 MyBatis 和 创建 映射 文件 ,你 就 已 经 准备 好 来 提升 技能 了 。 
MyBatis 的 Java API 就 是 你 收获 你 所 做 的 努力 的 地 方 。 正 如 你 即将 看 到 的 ,和 
JDBC 相 比 , MyBatis 很 大 程度 简化 了 你 的 代码 而 且 保 持 简洁 ,很 容易 理解 和 维护 。 
MyBatis 3 已 经 引入 了 很 多 重要 的 改进 来 使 得 SQL 映射 更 加 优秀 。 


应 用 目录 结构 

在 我 们 深入 Java API 之 前 ,理解 关于 目录 结构 的 最 佳 实践 是 很 重要 的 。MyBatis JE 
常 灵 活 , 你 可 以 用 你 自己 的 文件 来 做 几乎 所 有 的 事情 。 但 是 对 于 任 一 框架 , 都 有 一 
些 最 佳 的 方式 。 

让 我 们 看 一 下 典型 应 用 的 目录 结构 : 


/my_application 


/bin 
/devlib 
+2 Wild ^«-- MyBatis *.jarX(fFfExBH, ^** 
/src 
/org/myapp/ 
/action 
**/data `<-- MyBatis 配 置 文件 在 这 里 ， 包括 映 射 器 类 ， XML 配 


/mybatis-config.xml 
/BlogMapper .java 
/BlogMapper.xml 
/model 
/service 
/view 
**/properties ^«-- 在 你 XML 中 配置 的 属性 文件 在 这 里 。 ^** 
/test 
/org/myapp/ 
/action 
/data 
/model 
/service 
/view 
/properties 
/web 
/WEB - INF 
/web.xml 





Remember, these are preferences, not requirements, but others will thank you for 
using a common directory structure. 


这 部 分 内 容 剩 余 的 示例 将 假设 你 使 用 了 这 种 目录 结构 。 


SqlSessions 


使 用 MyBatis 的 主要 Java 接口 就 是 SqlSession。 尽 管 你 可 以 使 用 这 个 接口 执行 命 
4k 取 映 射 器 和 管理 事务 。 我 们 会 讨论 SqlSession 本 身 更 多 ,但 是 首先 我 们 还 是 要 
了 解 如 果 获 取 一 个 SqlSession 实例 。SqlSessions 是 由 SqlSessionFactory 实例 
创建 的 。SqlSessionFactory 对 象 包 含 创建 SqlSession 实 例 的 所 有 方法 。 

而 SqlSessionFactory 本 身 是 由 SqlSessionFactoryBuilder 创建 的 , 它 可 以 从 XML 
配置 ,注解 或 手动 配置 Java 来 创建 SqlSessionFactory。 


NOTE When using MyBatis with a dependency injection framework like Spring or 
Guice, SqlSessions are created and injected by the DI framework so you don't 
need to use the SqlSessionFactoryBuilder or SqlSessionFactory and can go 
directly to the SqlSession section. Please refer to the MyBatis-Spring or MyBatis- 
Guice manuals for further info. 


SqlSessionFactoryBuilder 


SqlSessionFactoryBuilder 有 五 个 build() 方 法 ,每 一 种 都 允许 你 从 不 同 的 资源 中 创建 
一 个 SqlSession 实例 。 


SqlSessionFactory build(InputStream inputStream) 

SqlSessionFactory build(InputStream inputStream, String environment 
SqlSessionFactory build(InputStream inputStream, Properties proper! 
SqlSessionFactory build(InputStream inputStream, String env, Prope! 
SqlSessionFactory build(Configuration config) 
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第 一 种 方法 是 最 常用 的 , 它 使 用 了 一 个 参照 了 XML 文档 或 上 面 讨 论 过 的 更 特定 的 
mybatis-config.xml 文件 的 Reader 实例 。 Ait HBR environment 和 
properties, Environment 决定 加 载 哪 种 环境 ,包括 数据 源 和 事务 管理 器 。 比 如 : 





<environments default="development"> 
<environment id="development"> 
«transactionManager type="JDBC"> 


<dataSource type="POOLED"> 
</environment> 
<environment id="production"> 
<transactionManager type="MANAGED"> 
<dataSource type="JNDI"> 


</environment> 
</environments> 


如 果 你 调用 了 一 个 使 用 environment 参数 方 式 的 build 方法 , 那么 MyBatis 将 会 使 
用 configuration 对 象 来 配置 这 个 environment。 当然 , 如 果 你 指定 了 一 个 不 合法 的 
environment, 你 会 得 到 错误 提示 。 如 果 你 调用 了 其 中 之 一 没有 environment 参数 的 
build 方法 , 那么 就 使 用 默认 的 environment( 在 上 面 的 示例 中 就 会 指定 为 
default="development”). 


如 果 你 调用 了 使 用 properties 实例 的 方法 ,那么 MyBatis 就 会 加 载 那 些 
properties( 属 性 配置 文件 ) ,并 你 在 你 配置 中 可 使 用 它们 。 那 些 属性 可 以 用 
${propName} 语 法 形式 多 次 用 在 配置 文件 中 。 


回想 一 下 ,属性 可 以 从 mybatis-config.xml 中 被 引用 ,或 者 直接 指定 它 。 因 此 理解 优先 
级 是 很 重要 的 。 我 们 在 文档 前 面 已 经 提 及 它 了 ,但 是 这 里 要 再 次 重申 : 


如 果 一 个 属性 存在 于 这 些 位 置 ,那么 MyBatis 将 会 按 找 下 面 的 顺序 来 加 载 它们 : 


。 在 properties 元 素 体 中 指定 的 属性 首先 被 读 取 ， 

e 从 properties 元 素 的 类 路 径 resource 或 url 指定 的 属性 第 二 个 被 读 取 , TB 
盖 已 经 指定 的 重复 属性 ， 

e 作为 方法 参 数 传递 的 属性 最 后 被 读 取 , 可 以 覆盖 已 properties 元 518% 
resource/url 属性 中 加 载 的 任意 重复 属性 。 


因此 ,最 高 优先 级 的 属性 是 通过 方法 参数 传递 的 ,之 后 是 resource/url 属性 指定 的 ,最 
后 是 在 properties 元 素 体 中 指定 的 属性 。 


总 结 一 下 ,前 四 个 方法 很 大 程度 上 是 相同 的 ,但 是 由 于 可 以 覆盖 ,就 允许 你 可 选 地 指定 
environment 和 /或 properties。 这 里 给 出 一 个 从 mybatis-config.xml 文件 创建 
SqlSessionFactory 的 示例 : 


String **resource** = "org/mybatis/builder/mybatis-config.xml"; 
InputStream **inputStream** = Resources.getResourceAsStream(resour¢ 
SqlSessionFactoryBuilder **builder** = new SqlSessionFactoryBuilde! 
SqlSessionFactory **factory** = builder.build(inputStream) ; 
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注意 这 里 我 们 使 用 了 Resources 工具 类 ,这 个 类 在 org.mybatis.io 包 中 。Resources 
类 正 如 其 名 ,会 帮助 你 从 类 路 径 下 ,文件 系统 或 一 个 web URL 加 载 资 源 文 件 。 看 一 
下 这 个 类 的 源 代码 或 者 通过 你 的 IDE 来 查看 ,就 会 看 到 一 整套 有 用 的 方法 。 这 里 给 
出 一 个 简 表 : 


URL getResourceURL(String resource) 

URL getResourceURL(ClassLoader loader, String resource) 
InputStream getResourceAsStream(String resource) 

InputStream getResourceAsStream(ClassLoader loader, String resource 
Properties getResourceAsProperties(String resource) 

Properties getResourceAsProperties(ClassLoader loader, String resol 
Reader getResourceAsReader(String resource) 

Reader getResourceAsReader(ClassLoader loader, String resource) 
File getResourceAsFile(String resource) 

File getResourceAsFile(ClassLoader loader, String resource) 
InputStream getUrlAsStream(String urlString) 

Reader getUrlAsReader(String urlString) 

Properties getUrlAsProperties(String urlString) 

Class classForName(String className) 
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最 后 一 个 build 方法 使 用 了 一 个 Configuration 3:6, configuration 类 包含 你 可 能 需 
要 了 解 SqlSessionFactory 实例 的 所 有 内 容 。Configuration 类 对 于 配置 的 自 查 很 有 
用 ,包含 查找 和 操作 SQL 映射 (不 推荐 使 用 ,因为 应 用 正 接收 请 求 ) configuration 类 
有 所 有 配置 的 开关 , 这 些 你 已 经 了 解 了 ,只 在 Java API 中 露出 来 。 这 里 有 一 个 简单 的 
示例 ,如 何 手 动 配置 configuration 实例 ,然后 将 它 传递 给 build() 方 法 来 创建 
SqlSessionFactory. 





DataSource dataSource = BaseDataTest.createBlogDataSource(); 
TransactionFactory transactionFactory = new JdbcTransactionFactoryi 


Environment environment = new Environment("development", transactic 


Configuration configuration - new Configuration(environment); 
configuration.setLazyLoadingEnabled(true); 
configuration.setEnhancementEnabled(true); 
configuration.getTypeAliasRegistry().registerAlias(Blog.class); 
configuration.getTypeAliasRegistry().registerAlias(Post.class); 
configuration.getTypeAliasRegistry().registerAlias(Author.class); 
configuration.addMapper(BoundBlogMapper.class); 
configuration.addMapper(BoundAuthorMapper.class); 


SqlSessionFactoryBuilder builder - new SqlSessionFactoryBuilder(); 
SqlSessionFactory factory - builder.build(configuration); 


E — g 
现在 你 有 一 个 SqlSessionFactory, 可 以 用 来 创建 SqlSession 实例 。 





SqlSessionFactory 


SqlSessionFactory 有 六 个 方法 可 以 用 来 创建 SqlSession 实例 。 通 常 来 说 ,如 何 决 
定 是 你 选择 下 面 这 些 方 法 时 : 


e Transaction (事务 ): 你 想 为 session 使 用 事务 或 者 使 用 自动 提交 (通常 意味 着 很 
多 数据 库 和 /或 JDBC 驱动 没有 事务 )? 

e Connection (连接 ): 你 想 MyBatis 获得 来 自 配置 的 数据 源 的 连接 还 是 提供 你 自 
E 

e Execution (执行 ): 你 想 MyBatis 复 用 预 处 理 语句 和 /或 批量 更 新 语句 (包括 插入 
和 删除 )? 


重 载 的 openSession() 方 法 签名 设置 允许 你 选择 这 些 可 选中 的 任何 一 个 组 合 。 


SqlSession openSession() 

SqlSession openSession(boolean autoCommit) 

SqlSession openSession(Connection connection) 

SqlSession openSession(TransactionIsolationLevel level) 

SqlSession openSession(ExecutorType execType, TransactionIsolationLe 
SqlSession openSession(ExecutorType execType) 

SqlSession openSession(ExecutorType execType, boolean autoCommit ) 
SqlSession openSession(ExecutorType execType, Connection connectior 
Configuration getConfiguration(); 


Ki 
默认 的 openSession() 方 法 没有 参数 , 它 会 创建 有 如 下 特性 的 SqlSession: 


会 开启 一 个 事务 (也 就 是 不 自动 提交 ) 

连接 对 象 会 从 由 活动 环境 配置 的 数据 源 实例 中 得 到 。 
事务 隔离 级 别 将 会 使 用 驱动 或 数据 源 的 默认 设置 。 
预 处 理 语句 不 会 被 复 用 ,也 不 会 批量 处 理 更 新 。 


这 些 方法 大 都 可 以 自我 解释 的 。 开启 自动 提交 , “true” 传 递 给 可 选 的 autoCommit 
参数 。 提供 自 定 义 的 连接 ,传递 一 个 Connection 实例 给 connection 参数 。 注 意 没 
有 覆盖 同时 设置 Connection 和 autoCommit 两 者 的 方法 ,因为 MyBatis 会 使 用 当前 
connection 对 象 提供 的 设 iB, MyBatis 为 事务 隔离 级 别 调用 使 用 一 个 Java 枚 举 包 
装 器 , 称 为 TransactionlsolationLevel, 否则 它们 按 预 期 的 方式 来 工作 ,并 有 JDBC x 
持 的 5 级 (NONE,READ_ UNCOMMITTED,READ COMMITTED,REPEA 
TABLE_READ,SERIALIZA BLE) 


还 有 一 个 可 能 对 你 来 说 是 新 见 到 的 参数 ,就 是 ExecutorType。 这 个 枚 举 类 型 定义 了 
3 个 值 : 


e ExecutorType.SIMPLE : 这 个 执行 器 类 型 不 做 特殊 的 事情 。 它 为 每 个 语句 的 
执行 创建 一 个 新 的 预 处 理 语句 。 

e ExecutorType.REUSE : 这 个 执行 器 类 型 会 复 用 预 处 理 语句 。 

e ExecutorType.BATCH : 这 个 执行 器 会 批量 执行 所 有 更 新 语句 ,如 果 SELECT 
在 它们 中 间 执 行 还 会 标定 它们 是 必须 的 ,来 保证 一 个 简单 并 易于 理解 的 行为 。 


注意 在 SqlSessionFactory 中 还 有 一 个 方法 我 们 没有 提 及 ,就 是 
getConfiguration(), 3x 个 方法 会 返回 一 个 Configuration 实例 ,在 运行 时 你 可 以 使 用 
它 来 自 检 MyBatis 的 配置 。 





注意 如 果 你 已 经 使 用 之 前 版 本 MyBatis, 你 要 回忆 那些 session,transaction 和 batch 
都 是 分 离 的 。 现 在 和 以 往 不 同 了 ,这 些 都 包含 在 session 的 范围 内 了 。 你 需要 义理 分 
FLE 事务 或 批量 操作 来 得 到 它们 的 效果 。 


SqlSession 


如 上 面 所 提 到 的 ,SqlSession 实例 在 MyBatis 中 是 非常 强大 的 一 个 类 。 在 这 里 你 会 
发 现 所 有 执行 语句 的 方法 ,提交 或 回 滚 事务 ,还 有 获取 映射 器 实例 。 


在 SqlSession 类 中 有 超过 20 个 方法 ,所 以 将 它们 分 开 成 易于 理解 的 组 合 。 
语句 执行 方法 


这 些 方法 被 用 来 执行 定义 在 SQL 映射 的 XML 文件 中 的 SELECT,INSERT,UPDA E 
T 和 DELETE 语句 。 它 们 都 会 自行 解释 ,每 一 句 都 使 用 语句 的 ID 属性 和 参数 对 象 ， 
参数 可 以 是 原生 类 型 (自动 装 箱 或 包装 类 ) ,JavaBean,POJO 或 Map。 


<T> T selectOne(String statement, Object parameter) 

«E» List«E» selectList(String statement, Object parameter) 

«K, V» Map«K,V» selectMap(String statement, Object parameter, String 
int insert(String statement, Object parameter) 

int update(String statement, Object parameter) 

int delete(String statement, Object parameter) 


国定 = 


selectOne 和 selectList 的 不 同 仅 仅 是 selectOne 必须 返回 一 个 对 象 。 如 果 多 余 一 
个 , 或 者 没有 返回 (或 返回 了 null) 那么 就 会 抛 出 异常 。 , 如果 你 不 知道 需要 多 少 对 
象 , 使 用 selectList。 


如 果 你 想 检 查 一 个 对 象 是 否 存 在 ,那么 最 好 返回 统计 数 (0 或 1) 。 因 为 并 不 是 所 有 语 
句 都 需 要 参数 ,这 些 方 法 都 是 有 不 同 重 载 版 本 的 ,它们 可 以 不 需要 参数 对 象 。 





«T» T selectOne(String statement) 

«E» List«E» selectList(String statement) 

«K, V» Map<K,V> selectMap(String statement, String mapKey) 
int insert(String statement) 

int update(String statement) 

int delete(String statement) 


最 后 ,还 有 查询 方法 的 三 个 高 级 版 本 ,它们 允许 你 限制 返回 行 数 的 范围 ,或 者 提供 自 定 
义 结果 控制 逻辑 ,这 通常 用 于 大 量 的 数据 集合 。 


<E> List<E> selectList (String statement, Object parameter, RowBour 
«K, V» Map<K,V> selectMap(String statement, Object parameter, String 
void select (String statement, Object parameter, ResultHandler<T> | 
void select (String statement, Object parameter, RowBounds rowBount 
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RowBounds 参数 会 告诉 MyBatis 略 过 指定 数量 的 记录 ,还 有 限制 返回 结果 的 数量 。 
RowBounds 类 有 一 个 构造 方法 来 接收 offset 和 limit, 否 则 是 不 可 改变 的 。 


int offset = 100; 
int limit = 25; 
RowBounds rowBounds = new RowBounds(offset, limit); 


不 同 的 驱动 会 实现 这 方面 的 不 同 级 别 的 效率 。 对 于 最 佳 的 表现 ,使 用 结果 集 类 型 的 
SCROLL SENSITIVE 或 SCROLL. INSENSITIVE( 或 句 话说 :不 是 
FORWARD ONLY). 


ResultHandler 参数 允许 你 按 你 喜欢 的 方式 处 理 每 一 行 。 你 可 以 将 它 添加 到 List Fh, 
创 Map, 或 抛 出 每 个 结果 而 不 是 只 保留 总 计 。 Set 你 可 以 使 用 ResultHandler 做 
很 多 漂亮 的 事 , 那 就 是 MyBatis 内 部 创建 结果 集 列 表 。 


它 的 接口 很 简单 。 
package org.apache.ibatis.session; 
public interface ResultHandler<T> { 


void handleResult(ResultContext<? extends T> context); 


} 
ResultContext 参数 给 你 访问 结果 对 象 本 身 的 方法 , 大 量 结果 对 象 被 创建 , 你 可 以 使 
用 布 尔 返回 值 的 stop() 方 法 来 停止 MyBatis 加 载 更 多 的 结果 。 


Batch update statement Flush Method 


There is method forflushing(executing) batch update statements that stored in a 
JDBC driver class at any timing. This method can be used when you use the 
ExecutorType.BATCH as ExecutorType . 


List<BatchResult> flushStatements() 


事务 控制 方法 
控制 事务 范围 有 四 个 方法 。 当然 , 如 果 你 已 经 选择 了 自动 提交 或 你 正在 使 用 外 部 事 


务 管 理 器 ,这 就 没有 任何 效果 了 。 然而, 如果 你 正在 使 用 JDBC 事务 管理 员 , 由 
Connection 实 例 来 控制 ,那么 这 四 个 方法 就 会 派 上 用 场 : 


void commit() 

void commit(boolean force) 
void rollback() 

void rollback(boolean force) 


默认 情况 下 MyBatis 不 会 自动 提交 事务 , 除非 它 侦 测 到 有 插入 , 更 新 或 删除 操作 改变 
了 数据 库 。 如 果 你 已 经 做 出 了 一 些 改变 而 没有 使 用 这 些 方法 ,那么 你 可 以 传递 true 
到 commit 和 rollback 方法 来 保证 它 会 被 提交 (注意 ,你 不 能 在 自动 提交 模式 下 强制 
session, 或 者 使 用 了 外 部 事务 管理 器 时 ) 。 很 多 时 候 你 不 用 调用 rollback(), 因 为 如 果 
你 没有 调用 commit 时 MyBatis 会 蔡 你 完成 。 然 而 ,如 果 你 需要 更 多 对 多 提交 和 回 滚 
都 可 能 的 session 的 细 粒 度 控 制 ,你 可 以 使 用 回 滚 选择 来 使 它 成 为 可 能 。 


NOTE MyBatis-Spring and MyBatis-Guice provide declarative transaction 
handling. So if you are using MyBatis with Spring or Guice please refer to their 
specific manuals. 


清理 Session 级 的 缓存 


void clearCache() 


SqlSession 实例 有 一 个 本 地 缓存 在 执行 update,commit,rollback 和 close 时 被 清 
HB, Ze 明确 地 关闭 它 ( 获 取 打 算 做 更 多 的 工作 ) ,你 可 以 调用 clearCache()。 


确保 SqlSession 被 关闭 


void close() 


你 必须 保证 的 最 重要 的 事情 是 你 要 关闭 所 打开 的 任何 session。 保 证 做 到 这 点 的 最 
EA 式 是 下 面 的 工作 模式 : 


SqlSession session = sqlSessionFactory.openSession(); 
try { 
// following 3 lines pseudocod for "doing some work" 
session.insert(...); 


session.update(...); 
session.delete(...); 
session.commit(); 

} finally { 


session.close(); 


还 有 ， 如 果 你 正在 使 用 jdk 1.7 以 上 的 版 本 还 有 MyBatis 3.2 以 上 的 版 本 ， 你 可 以 使 用 
try-with-resources 语 句 : 


try (SqlSession session = sqlSessionFactory.openSession()) ( 
// following 3 lines pseudocode for "doing some work" 
session.insert(...); 
session.update(...); 
session.delete(...); 
session.commit(); 


注意 就 像 SqlSessionFactory, 你 可 以 通过 调用 getConfiguration()73 7 3 4S 
SqlSession 使 用 的 Configuration 实例 


Configuration getConfiguration() 


使 用 映射 器 


<T> T getMapper (Class<T> type) 


上 述 的 各 个 insert,update,delete 和 select 方法 都 很 强大 ,但 也 有 些 繁琐 ,没有 类 型 安 
全 ,对 于 你 的 IDE 也 没有 帮助 ,还 有 可 能 的 单元 测试 。 在 上 面 的 入门 章节 中 我 们 已 经 
看 到 了 一 个 使 用 映射 器 的 示例 。 


因此 , 一 个 更 通用 的 方式 来 执行 映射 语句 是 使 用 映射 器 类 。 一 个 映射 器 类 就 是 一 个 
简单 的 接口 ,其 中 的 方法 定义 匹配 于 SqlSession 方法 。 下 面 的 示例 展示 了 一 些 方法 
签名 和 它们 是 如 何 映 射 到 SqlSession BJ, 


public interface AuthorMapper { 
// (Author) selectOne("selectAuthor",5); 
Author selectAuthor(int id); 
// (List<Author>) selectList(“selectAuthors”) 
List<Author> selectAuthors(); 
// (Map<Integer,Author>) selectMap("selectAuthors", "id") 
QMapKey ( " id") 
Map«Integer, Author» selectAuthors(); 
// insert("insertAuthor", author) 
int insertAuthor(Author author); 
// updateAuthor("updateAuthor", author) 
int updateAuthor(Author author); 
// delete("deleteAuthor",5) 
int deleteAuthor(int id); 


总 之 , 每 个 映射 器 方法 签名 应 该 匹配 相关 联 的 SqlSession 方法 , 而 没有 字符 串 参 数 
ID. 相反 ,方法 名 必须 匹配 映射 语句 的 ID. 


此 外 ,返回 类 型 必须 匹配 期 望 的 结果 类 型 。 所 有 常用 的 类 型 都 是 支持 的 ,包括 :原生 类 
型 ,Map,POJO 和 JavaBean。 


映射 器 接口 不 需要 去 实现 任何 接口 或 扩展 任何 类 。 只 要 方法 前 面 可 以 被 用 来 唯一 标 
识 对 应 的 映射 语句 就 可 以 了 。 


映射 器 接口 可 以 扩展 其 他 接口 。 当 使 用 XML 来 构建 映射 器 接口 时 要 保证 在 合适 的 
命名 空间 中 有 语句 。 而 且 , 唯一 的 限制 就 是 你 不 能 在 两 个 继承 关系 的 接口 中 有 相同 
的 方法 签名 (这 也 是 不 好 的 想法 )。 


你 可 以 传递 多 个 参数 给 一 个 映射 器 方法 。 如 果 你 这 样 做 了 , 默认 情况 下 它们 将 会 以 
它们 在 参数 列表 中 的 位 置 来 命名 ,比如 :#{param1},#{param2} 等 。 如 果 你 想 改 变 参 数 
的 名 称 (只 在 多 参数 情况 下 ) ,那么 你 可 以 在 参数 上 使 用 @Param(“paramName”) 注 
解 。 


你 也 可 以 给 方法 传递 一 个 RowBounds 实例 来 限制 查询 结果 。 
映射 器 注解 


因为 最 初 设计 时 ,MyBatis 是 一 个 XML 驱动 的 框架 。 配 置信 息 是 基于 XML 的 ,而 且 
映射 语句 也 是 定义 在 XML 中 的 。 而 到 了 MyBatis 3, 有 新 的 可 用 的 选择 了 。MyBatis 
3 构建 在 基于 全 面 而 且 强 大 的 Java 配置 API 之 上 。 这 个 配置 API 是 基于 XML 的 
MyBatis 配置 的 基础 ,也 是 新 的 基于 注解 配置 的 基础 。 注 解 提供 了 一 种 简单 的 方式 来 
实现 简单 映射 语句 ,而 不 会 引入 大 量 的 开销 。 

注意 不 幸 的 是 ,Java 注解 限制 了 它们 的 表现 和 灵活 。 尽 管 很 多 时 间 都 花 调查 ,设计 和 
实验 上 ,最 强大 的 MyBatis 映射 不 能 用 注解 来 构建 , 那 并 不 可 笑 。C# 属 性 (做 示例 ) 就 
没 有 这 些 限 制 ,因此 MyBatis.NET 将 会 比 XML 有 更 丰富 的 选择 。 也 就 是 说 ,基于 
Java 注解 的 配置 离 不 开 它 的 特性 。 

注解 有 下 面 这 些 : 


注解 目标 相对 应 的 XML 
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映射 语句 的 属性 
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映射 申明 样 例 
这 个 例子 展示 了 如 何 使 用 @SelectKey 注解 来 在 插入 前 读 取 数据 库 序列 的 值 : 


QInsert("insert into table3 (id, name) values(#{nameId}, #{name})" 
@SelectKey(statement="call next value for TestSequence", keyPropert 
**int** insertTable3(Name name); 





这 个 例子 展示 了 如 何 使 用 O SelectKey 注解 来 在 插入 后 读 取 数 据 库 识别 列 的 值 : 


QInsert("insert into table2 (name) values(#{name})") 
@SelectKey(statement="call identity()", keyProperty="nameId", befoi 
**int** insertTable2(Name name); 


«| = 








This example shows using the @Flush annotation to call the 
SqlSession#flushStatements() : 


@Flush 
List<BatchResult> flush(); 


These examples show how to name a ResultMap by specifying id attribute of 
@Results annotation. 


QResults(id = "userResult", value = 
@Result(property = "id", column = "uid", id = **true**), 
QResult(property = "firstName", column = "first name"), 
QResult(property - "lastName", column - "last name") 

}) 


OSelect("select * from users where id = #{id}") 
User getUserById(Integer id); 


QResults(id = "companyResults") 


@ConstructorArgs({ 
@Arg(property = "id", column = "cid", id = **true**), 
@Arg(property = "name", column = "name") 

3) 


QSelect("select * from company where id = #{id}") 
Company getCompanyById(Integer id); 


SQL 语句 构建 器 类 


问题 


Java 程 序 员 面 对 的 最 痛苦 的 事情 之 一 就 是 在 Java 代 码 中 能 入 SQL 语句 。 这 人 么 来 做 通 
常 是 由 于 SQL 语句 需要 动态 来 生成 -否则 可 以 将 它们 放 到 外 部 文件 或 者 存储 过 程 中 。 

正如 你 已 经 看 到 的 那样 ，MyBatis 在 它 的 XML 映射 特性 中 有 一 个 强大 的 动态 SQL 生 

成 方案 。 但 有 时 在 Java 代 码 内 部 创建 SQL 语句 也 是 必要 的 。 此 时 ，MyBatis 有 另外 

一 个 特性 可 以 帮 到 你 ， 在 减少 典型 的 加 号 ,引号 ,新 行 ,格式 化 问题 和 镀 入 条 件 来 处 理 
多 余 的 去 号 或 AND 连接 词 之 前 。 事 实 上 ， 在 Java 代 码 中 来 动态 生成 SQL 代码 就 是 

一 场 重 梦 。 例 如 : 


String sql = "SELECT P.ID, P.USERNAME, P.PASSWORD, P.FULL NAME, " 
"P.LAST NAME,P.CREATED ON, P.UPDATED ON " + 

"FROM PERSON P, ACCOUNT A " + 

"INNER JOIN DEPARTMENT D on D.ID = P.DEPARTMENT ID " + 
"INNER JOIN COMPANY C on D.COMPANY ID = C.ID " + 
"WHERE (P.ID = A.ID AND P.FIRST NAME like ?) " + 

"OR (P.LAST NAME like ?) " + 

"GROUP BY P.ID " + 

"HAVING (P.LAST NAME like ?) " + 

"OR (P.FIRST NAME like ?) " + 

"ORDER BY P.ID, P.FULL NAME"; 


BES | | 
The Solution 


MyBatis 3 提供 了 方便 的 工具 类 来 帮助 解决 该 问题 。 使 用 SQL 类 ， 简 单 地 创建 一 个 实 
例 来 调用 方法 生成 SQL 语句 。 上 面 示例 中 的 问题 就 像 重 写 SQL 类 那样 : 


private String selectPersonSql() { 

return new SQL() {{ 
SELECT("P.ID, P.USERNAME, P.PASSWORD, P.FULL NAME"); 
SELECT("P.LAST NAME, P.CREATED ON, P.UPDATED ON"); 
FROM("PERSON P"); 
FROM("ACCOUNT A"); 
INNER JOIN("DEPARTMENT D on D.ID - P.DEPARTMENT ID"); 
INNER JOIN("COMPANY C on D.COMPANY ID - C.ID"); 
WHERE("P.ID - A.ID"); 
WHERE("P.FIRST NAME like ?"); 
OR(); 
WHERE("P.LAST NAME like ?"); 
GROUP. BY("P.ID"); 
HAVING("P.LAST NAME like ?"); 
OR(); 
HAVING("P.FIRST_NAME like ?"); 
ORDER_BY("P.ID"); 
ORDER BY("P.FULL NAME"); 

}}.toString(); 


} 


该 例 中 有 什么 特殊 之 处 ? 当 你 仔细 看 时 ， 那 不 用 担心 偶然 间 重 复出 现 的 "AND" 关 键 
字 ， 或 者 在 "WHERE'" 和 "AND" 之 间 的 选择 ， 抑 或 什么 都 不 选 。 该 SQL 类 非常 注 
意 "WHERE" 应 该 出 现在 何 处 ， 哪 里 又 应 该 使 用 "AND"， 还 有 所 有 的 字符 串 链 接 。 


SQL Z 
这 里 给 出 一 些 示 例 : 


// Anonymous inner class 
public String deletePersonSql() { 
return new SQL() II 
DELETE FROM("PERSON"); 
WHERE("ID = ${id}"); 
}}.toString(); 
j 


// Builder / Fluent style 
public String insertPersonSql() { 
String sql - new SQL() 
.INSERT INTO("PERSON") 
.VALUES("ID, FIRST NAME", "${id}, ${firstName}") 
.VALUES("LAST NAME", "${lastName}") 
.toString() ， 
return sql; 


j 


// With conditionals (note the final parameters, required for the : 
public String selectPersonLike(final String id, final String first! 


return new SQL() (1 
SELECT("P.ID, P.USERNAME, P.PASSWORD, P.FIRST NAME, P.LAST NAME 
FROM("PERSON P"); 
if (id != null) { 
WHERE("P.ID like ${id}"); 


if (firstName !- null) ( 
WHERE("P.FIRST NAME like ${firstName}"); 


if (lastName != null) { 
WHERE("P.LAST NAME like ${lastName}"); 


j 
ORDER BY("P.LAST NAME"); 
}}.toString(); 
} 


public String deletePersonSql() { 
return new SQL() {{ 
DELETE FROM("PERSON"); 
WHERE("ID = ${id}"); 
}}.toString(); 
} 


public String insertPersonSql() { 
return new SQL() (1 
INSERT INTO("PERSON"); 
VALUES("ID, FIRST NAME", "${id}, ${firstName}"); 
VALUES("LAST. NAME", "${lastName}"); 
}}.toString(); 
j 


public String updatePersonSql() { 
return new SQL() {{ 
UPDATE ("PERSON"); 
SET("FIRST NAME = ${firstName}"); 
WHERE("ID = ${id}"); 
}}.toString(); 





方法 描述 


开始 或 插入 到 SELECT FH, 可 以 被 多 次 
调用 ， 参 数 也 会 添加 到 SELECT 子 句 。 参 
数 通常 使 用 去 号 分 隔 的 列 名 和 别名 列表 ， 但 
也 可 以 是 数据 库 驱 动 程序 接受 的 任意 类 型 。 


开始 或 插入 到 SELECT FH, 也 可 以 插入 
DISTINCT 关键 字 到 生成 的 查询 语句 中 。 
l 可 以 被 多 次 调用 ， 参 数 也 会 添加 到 
SELECT_DISTINCT(String) SELECT F^. 参数 通常 使 用 逗号 分 隔 的 


SELECT(String) 


FROM(String) 


JOIN(String) 
INNER_JOIN(String) 
LEFT_OUTER_JOIN(String) 
RIGHT_OUTER_JOIN(String) 
WHERE (String) 


OR() 


AND( ) 


GROUP_BY(String) 


HAVING(String) 


ORDER_BY(String) 


DELETE_FROM(String) 


INSERT_INTO(String) 


SET(String ) 


UPDATE(String) 


列 名 和 别名 列表 ， 但 也 可 以 是 数据 库 驱 动 程 
序 接受 的 任意 类 型 。 


开始 或 插入 到 FROM 子 句 。 可 以 被 多 次 调 
用 ， 参 数 也 会 添加 到 FROM 子 句 。 参数 通 
常 是 表 名 或 别名 ， 也 可 以 是 数据 库 驱 动 程序 
接受 的 任意 类 型 。 


基于 调用 的 方法 ， 添 加 新 的 合适 类 型 的 
JOIN 子 句 。 参数 可 以 包含 由 列 命 和 join on 
条 件 组 合成 标准 的 join。 


插入 新 的 WHERE 子 句 条 件 ， 由 AND 4 
接 。 可 以 多 次 被 调用 ， 每 次 都 由 AND 来 链 
接 新 条 件 。 使 用 oR() 来 分 隔 OR 。 


使 用 oR 来 分 隔 当 前 的 WHERE 子 句 条 件 。 
可 以 被 多 次 调用 ， 但 在 一 行 中 多 次 调用 或 生 
成 不 稳定 的 SQL 。 


使 用 AND 来 分 隔 当 前 的 WHERE SAR 
件 。 可 以 被 多 次 调用 ， 但 在 一 行 中 多 次 调用 
或 生成 不 稳定 的 SQL o AA WHERE 和 
HAVING 二 者 都 会 自动 链接 AND , 这 是 非 
常 军 见 的 方法 ， 只 是 为 了 完整 性 才 被 使 用 。 


插入 新 的 GROUP BY 子 句 元 素 ， 由 逗号 连 
E. 可 以 被 多 次 调用 ， 每 次 都 由 至 号 连接 新 


AR. 


插入 新 的 HAVING 子 句 条 件 。 由 AND 连 
接 。 可 以 被 多 次 调用 ， 每 次 都 由 AND 来 连 
接 新 的 条 件 。 使 用 ORO 来 分 隔 OR. 


插入 新 的 ORDER BY 子 句 元 素 ， 由 逗号 连 
接 。 可 以 多 次 被 调用 ， 每 次 由 至 号 连接 新 的 


条 件 。 


开始 一 个 delete 语 句 并 指定 需要 从 哪个 表 删 
除 的 表 名 。 通 常 它 后 面 都 会 跟着 WHERE 话 
^g] | 


开始 一 个 insert 语 句 并 指定 需要 插入 数据 的 表 
名 。 后 面 都 会 跟着 一 个 或 者 多 个 
VALUES()。 


针对 update 语 句 ， 插 人 到 "set" 列 表 中 


开始 一 个 update 话 句 并 指定 需要 更 新 的 表 
BH, 后面 都 会 跟着 一 个 或 者 多 个 SET()， 通 
常 也 会 有 一 个 WHERE()。 


All; ` G D. a ` EF E Ł 
VALUES (String, String) E iR i 


SqlBuilder 和 SelectBuilder (已 经 废弃 ) 


在 3.2 版 本 之 前 ， 我 们 使 用 了 一 点 不 同 的 做 法 ， 通 过 实现 ThreadLocal 变 量 来 掩盖 一 
些 导 致 Java DSL 麻 烦 的 语言 限制 。 但 这 种 方式 已 经 废弃 了 ， 现 代 的 框架 都 欢迎 人 们 
使 用 构建 器 类 型 和 匿名 内 部 类 的 想法 。 因 此 ，SelectBuilder 和 SqlBuilder 3: $845 


FT. 
下 面 的 方法 仅仅 适用 于 废弃 的 SqlBuilder 和 SelectBuilder 类 。 


方法 描述 


这 些 方 法 清空 SelectBuilder 类 的 ThreadLocal 状 态 ， 并 且 准 各 一 个 
新 的 构建 语句 。 开 始 新 的 语句 时 ， BEGIN() 读 取得 最 好 。 由 于 
RESET() ZERA 〈 在 某 些 条 件 下 ， 也 许 是 逮 辑 需要 一 个 完全 不 同 的 语 
句 ) ， 在 执行 中 清理 语句 RESET() 读 取得 最 好 。 


返回 生成 的 SQL() 并 重 置 SelectBuilder 状态 (好 像 
SQL() BEGIN() 或 RESET() 被 调用 了 ). 因此 ， 该 方法 只 能 被 调用 一 
次 | 
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BEGIN( ) 
/ 


SelectBuilder 和 SqlBuilder 类 并 不 神奇 ， 但 是 知道 它们 如 何 工作 也 是 很 重要 的 。 
SelectBuilder 使 用 SqlBuilder f& Fi T 8$ 5 A fll ThreadLocal € AERA BS 
洁 语 法 ， 可 以 很 容易 地 和 条 件 交错 。 使 用 它们 ， 静 态 导 和 人 类 的 方法 即 可 ， 就 像 这 样 
(一 个 或 其 它 ， 并 非 两 者 ): 


import static org.apache.ibatis.jdbc.SelectBuilder.*; 


import static org.apache.ibatis.jdbc.SqlBuilder.*; 


这 就 允许 像 下 面 这 样 来 创建 方法 : 


/* DEPRECATED */ 
public String selectBlogsSql() { 
BEGIN(); // Clears ThreadLocal variable 
SELECT("*"); 
FROM("BLOG"); 
return SQL(); 


/* DEPRECATED */ 
private String selectPersonSql() { 
BEGIN(); // Clears ThreadLocal variable 
SELECT("P.ID, P.USERNAME, P.PASSWORD, P.FULL NAME"); 
SELECT("P.LAST NAME, P.CREATED ON, P.UPDATED ON"); 
FROM("PERSON P"); 
FROM("ACCOUNT A"); 
INNER JOIN("DEPARTMENT D on D.ID - P.DEPARTMENT ID"); 
INNER JOIN("COMPANY C on D.COMPANY ID - C.ID"); 
WHERE("P.ID - A.ID"); 
WHERE("P.FIRST NAME like ?"); 
OR(); 
WHERE("P.LAST NAME like ?"); 
GROUP BY("P.ID"); 
HAVING("P.LAST NAME like ?"); 
OR(); 
HAVING("P.FIRST NAME like ?"); 
ORDER BY("P.ID"); 
ORDER BY("P.FULL NAME"); 
return SQL(); 


Logging 
Mybatis 内 置 的 日 志 工 三 提 供 日 志 功 能 ， 具 体 的 日 志 实 现 有 以 下 几 种 工具 : 


SLF4J 

Apache Commons Logging 
Log4j 2 

Log4j 

JDK logging 


具体 选择 哪个 moa 3: 3i, T E EH MyBatisB Jj FH AGL He Eo 会 使 用 最 先 找到 的 
( 按 上 文 列举 的 顺序 查找 ) 。 如 果 一 个 都 未 找到 ， eg 


不 少 应 用 服务 器 的 classpath 中 已 经 包含 commons Logging， 如 Tomcat 和 
WebShpere, 所 以 MyBatis 会 把 它 作 为 具体 的 日 志 实 现 。 记 住 这 点 非常 重要 。 这 将 
意味 着 ， 在 诸如 WebSphere 的 环境 中 一 WebSphere 提供 了 Commons Logging 的 
私有 实现 ， 你 的 Log4J 配 置 将 被 忽略 。 这 种 做 法 不 免 让 人 悲 俊 ，MyBatis 怎 么 能 忽 
略 你 的 配置 虽 ? 事实 上 ， 因 Commons Logging 已 经 存 在 了 ， 按 照 优 先 级 顺序 ， 
Log4J 自 然 就 被 忽略 了 ! 不 过 ， 如 果 你 的 应 用 部 署 在 一 个 包含 commons Logging 的 
环境 ， 而 你 又 想 用 其 他 的 日 志 框 架 ， 你 可 以 根据 需要 调用 如 下 的 某 一 方法 : 





org.apache.ibatis.logging.LogFactory.useSlf4jLogging(); 
org.apache.ibatis.logging.LogFactory.useLog4JLogging(); 
org.apache.ibatis.logging.LogFactory.useJdkLogging(); 
org.apache.ibatis.logging.LogFactory.useCommonsLogging( ); 
org.apache.ibatis.logging.LogFactory.useStdOutLogging(); 


M re 请 在 其 他 所 有 MyBatis 方 法 之 前 调用 它 。 另 
外 ， 只 有 在 相应 日 志 实 现 中 存在 的 前 提 下 ， 调 用 对 应 的 方法 才 是 有 意义 的 ， 否 则 
MyBatis 一 概 忽略 。 如 你 环境 中 并 不 存在 Log4J， 你 却 调用 了 相应 的 方法 ，MyBatis 

就 会 忽略 这 一 调用 ， 代 之 默认 的 查找 顺序 查找 日 志 实 现 。 


关于 SLF4J、Apache Commons Logging、Apache Log4J 和 JDK Logging 的 API 介 
绍 已 经 超出 本 文档 的 范围 。 不 过 ， 下 面 的 例子 可 以 作为 一 个 快速 入门 。 关 于 这 些 日 
志 框 架 的 更 多 信息 ， 可 以 参考 以 下 链接 : 


e Apache Commons Logging 
e Apache Log4j 
e JDK Logging API 


Logging Configuration 


MyBatis 可 以 对 包 、 类 、 命 名 空间 和 全 限定 的 语句 记录 日 志 。 


具体 怎么 做 ， 视 使 用 的 日 志 框架 而 定 ， 这 里 以 Log4J 为 例 。 配 置 日 志 功 能 非常 简 
单 : 添加 几 个 配置 文件 ， 如 log4j.properties, 再 添加 个 jar 包 ， 如 log4j.jar。 下 面 是 具 
体 的 例子 ， 共 两 个 步骤 : 


步骤 1: 添加 Log4J 的 jar 包 


因为 采用 Log4J， 要 确保 在 应 用 中 对 应 的 jar 包 是 可 用 的 。 要 满足 这 一 点 ， 只 要 将 jar 
包 添 加 到 应 用 的 classpath 中 即 可 。 UD ODER ee 


具体 而 言 ， 对 于 web 或 企业 上 应用， 需要 将 1og4j.jar 添加 到 wEB-INF/lib H 
录 ; 对 于 独立 应 用 ， 可 以 将 它 添加 到 jvm 的 -classpath 启动 参数 中 。 


步骤 2 : 配置 Log4J 
配置 Log4J 比 较 简 单 ， 比如 需要 记录 这 个 mapper 接 口 的 日 志 : 


package org.mybatis.example; 

public interface BlogMapper { 
QSelect("SELECT * FROM blog WHERE id = #{id}") 
Blog selectBlog(int id); 


j 


只 要 在 应 用 的 classpath 中 创建 一 个 名 称 为 log4j.properties 的 文件 ， 文件 的 具 
体内 容 如 下 : 


# Global logging configuration 

log4j.rootLogger-ERROR, stdout 

# MyBatis logging configuration... 
1og4j.logger.org.mybatis.example.BlogMapper-TRACE 

# Console output... 
log4j.appender.stdout-org.apache.10g4j.ConsoleAppender 
log4j.appender.stdout.layout-org.apache.l0og4j.PatternLayout 
log4j .appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n 


添加 以 上 配置 后 ，Log4J 就 会 把 SE mybatis.example.BlogMapper 的 详细 执行 
日 志 记 录 下 来 ， 对 于 应 用 中 的 其 Em] | 仅仅 记录 错误 信息 。 


也 可 以 将 日 志 从 整个 mapper 接 口 级 别 调整 到 到 语句 级 别 ， 从 而 实现 更 细 粒 度 的 控 
制 。 如 下 配置 只 记录 selectBlog 语句 的 日 志 : 


log4j.logger.org.mybatis.example.BlogMapper.selectBlog-TRACE 


与 此 相对 ， 可 以 对 一 组 mapper 接 口 记录 日 志 ， 只 要 对 mapper 接 口 所 在 的 包 开 局 日 
志 功 能 即 可 : 


log4j.logger.org.mybatis.example-TRACE 


革 些 查询 可 能 会 返回 大 量 的 数据 ， 只 想 记 录 其 执行 的 SQL 语句 该 怎么 办 ?为 此 ， 
Mybatis 中 SQL 语 句 的 日 志 级 别 被 设 为 DEBUG (JDK Logging 中 为 FINE) ， 结 果 日 
志 的 级 别 为 TRACE (JDK Logging 中 为 FINER)。 所 以 ， 只 要 将 日 志 级 别 调整 为 
DEBUG 即 可 达到 目的 : 


log4j.logger.org.mybatis.example-DEBUG 


要 记录 日 志 的 是 类 似 下 面 的 mapper 文 件 而 不 是 mapper 接 口 又 该 怎么 呢 ? 


«?xml version="1.0" encoding="UTF-8" ?> 
<!DOCTYPE mapper 
PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" 
"http://mybatis.org/dtd/mybatis-3-mapper.dtd"> 
<mapper namespace="org.mybatis.example.BlogMapper"> 
<select id="selectBlog" resultType="Blog"> 
select * from Blog where id = #{id} 
</select> 
</mapper> 


对 这 个 文件 记录 日 志 ， 只 要 对 命名 空间 增加 日 志 记 录 功 能 即 可 : 


1og4j.logger.org.mybatis.example.BlogMapper-TRACE 


进一步 ， 要 记录 具体 语句 的 日 志 可 以 这 样 做 : 


log4j.logger.org.mybatis.example.BlogMapper.selectBlog-TRACE 


看 到 了 吧 ， 两 种 配置 没 差别 ! 


配置 文件 log4j.properties 的 余下 内 容 是 针对 日 志 格 式 的 ， 这 一 内 容 已 经 超出 
本 文档 范围 。 关 于 Log4J 的 更 多 内 容 ， 可 以 参考 Log4J 的 网 站 。 不 过 ， 可 以 简单 试 
一 下 看 看 ， 不 同 的 配置 会 产生 什么 不 一 桩 的 效果 。 


项 目 文档 


项 目 总 体 信息 


本 文档 提供 了 与 本 项 目 相 关 信 息 的 各 种 文档 和 链接 的 概述 。 这 里 的 所 有 内 容 都 是 根 
据 本 项 目 信 息 生 成 的 ， 自 动 生成 过 程 依靠 Maven o 


项 目 团 队 


源 代 码 库 
项 目 概要 


概述 
文档 描述 
持续 集成 持续 集成 是 以 一 定 的 频率 和 固定 的 基础 进行 代码 构建 和 测试 的 
m 过 程 ， 这 里 列 出 了 所 有 的 持续 集成 过 程 。 
项 目 依赖 这 一 文档 列 出 了 项 目的 依赖 并 提供 了 每 个 依赖 的 相关 信息 。 
Dependency This document describes how to to include this project as a 
Information dependency using various dependency management tools. 
Distribution This document provides informations on the distribution 
Management | management of this project. 
司 题 跟踪 这 是 本 项 目 中 的 问题 管理 系统 的 链接 。 用 户 可 以 在 这 里 进行 问 
a 题 (故障 、 特 性 、 变 更 请 求 ) 的 创建 和 查询 。 
项 目 授权 这 是 关于 本 项 目 授权 的 定义 。 
邮件 列表 本 文档 提供 了 本 项 目的 邮件 列表 的 订阅 和 为 档 信 息 。 
Plugin This document lists the plugins that are defined through 
Management pluginManagement. 
Project This document lists the build plugins and the report plugins 
Plugins used by this project. 


本 文档 提供 了 本 项 目 中 成 员 的 信息 .他 们 是 在 本 项 目 中 以 某 种 形 
式 做 出 了 贡献 的 个 人 . 


这 是 一 个 在 线 代 码 库 , 它 可 以 通过 Web 浏 览 器 进行 查看 . 
此 文档 列 出 了 该 项 目 其 它 的 相关 信息 


概述 

本 项 目 使 用 Travis Cl. 

访问 

以 下 是 在 本 项 目 中 使 用 的 持续 集成 系统 。 


[https://travis-ci.org/mybatis/mybatis-3/](https://travis-ci.org/m 
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提醒 方法 


未 定义 任何 的 提醒 方法 ， 请 以 后 再 查看 。 


项 目 依 赖 


compile 


以 下 是 这 一 项 目的 编译 依赖 列表 。 编 译 和 运行 本 应 用 需要 这 些 依赖 。 


Groupld 


cglib 


commons-logging 


log4j 


ognl 


org.apache.logging.log4j 


org.javassist 


org.slf4j 


org.slf4j 


test 


Artifactld 


cglib 


commons- 
logging 


log4j 


ognl 


log4j-core 


javassist 


sif4j-api 


slf4j- 
log4j12 


版 本 


3.1 


1.2 


1.2.17 


3.0.11 


2.3 


3.20.0- 


GA 


1.7.12 


reck 


jar 


jar 


jar 


jar 


jar 


jar 


License 


ASF 2.0 


The Apache 
Software 
License， 
Version 2.0 


The Apache 
Software 
License， 
Version 2.0 


The Apache 
Software 
License， 
Version 2.0 


The Apache 
Software 
License， 
Version 2.0 


MPL 1.1- 
LGPL 2.1- 
Apache 
License 2.0 


MIT License 


MIT License 


Yes 


Yes 


Yes 


Yes 


Yes 


Yes 


以 下 是 这 一 项 目的 测试 依赖 列表 。 这 些 依赖 仅仅 在 编译 和 运行 本 应 用 中 的 单元 测试 


时 需要 。 
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Groupld 
commons-dbcp 
javax.transaction 
junit 
org.apache.derby 
org.apache.velocity 


org.hsqldb 


org.mockito 


postgresql 


项 目 依 赖 


Artifactld 


commons- 
dbcp 


transaction- 
api 


junit 
derby 


velocity 


hsqldb 


mockito- 
core 


postgresql 


4.12 
TORIR 


1.7 


292 


1.10.19 


9.1-901- 
1.jdbc4 


I e 


License 


The Apache Software 
License, Version 2.0 


Eclipse Public 
License 1.0 


Apache 2 


The Apache Software 
License, Version 2.0 


HSQLDB License, a 
BSD open source 
license 


The MIT License 


BSD License 
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Dependency Information 
Apache Maven 


<dependency> 
<groupId>org.mybatis</groupId> 
«artifactId»mybatis«/artifactId» 
<version>3.4.0-SNAPSHOT</version> 
</dependency> 


Apache Buildr 


'org.mybatis:mybatis:jar:3.4.0-SNAPSHOT' 


Apache Ivy 


«dependency org="org.mybatis" name="mybatis" rev="3.4.0-SNAPSHOT"> 
«artifact name="mybatis" type="jar" /> 
</dependency> 
e - 11 
Groovy Grape 


QGrapes( 
@Grab(group='org.mybatis', module='mybatis', version='3.4.0-SNAPSH( 





Grails 


compile 'org.mybatis:mybatis:3.4.0-SNAPSHOT' 


Leiningen 


[org.mybatis/mybatis "3.4.0-SNAPSHOT" ] 


SBT 


libraryDependencies += "org.mybatis" % "mybatis" % "3.4.0-SNAPSHOT' 
El m | 











Overview 

The following is the distribution management information used by this project. 
Repository - sonatype-nexus-staging 
https://oss.sonatype.org/service/local/staging/deploy/maven2/ 


Snapshot Repository - sonatype-nexus-snapshots 
https://oss.sonatype.org/content/repositories/snapshots/ 
Site - gh-pages 


git:ssh://git@github.com/mybatis/mybatis-3.git?gh-pages# 


概述 

本 项 目 使 用 GitHub Issue Management 管 理 问题 。 

问题 跟踪 

问题 、 故 障 和 新 特性 请 求 请 通过 下 述 的 本 项 目的 问题 跟踪 系统 提交 。 


[https://github.com/mybatis/mybatis-3/issues](https://github.com/m 
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一 般 来 说 ， 项 目 中 所 列 的 授权 仅 对 项 目 自身 而 言 ， 不 包括 项 目的 依赖 。 


项 目 授权 


The Apache Software License, Version 2.0 


Apache License 
Version 2.0, January 2004 
http: //ww.apache.org/licenses/ 


TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 


1\. Definitions. 


"License" shall mean the terms and conditions for use, repro 
and distribution as defined by Sections 1 through 9 of this « 


"Licensor" shall mean the copyright owner or entity authorize 
the copyright owner that is granting the License. 


"Legal Entity" shall mean the union of the acting entity and 
other entities that control, are controlled by, or are under 
control with that entity. For the purposes of this definitior 
"control" means (i) the power, direct or indirect, to cause 1 
direction or management of such entity, whether by contract « 
otherwise, or (ii) ownership of fifty percent (50%) or more « 
outstanding shares, or (iii) beneficial ownership of such enl 


"You" (or "Your") shall mean an individual or Legal Entity 
exercising permissions granted by this License. 


"Source" form shall mean the preferred form for making modif: 
including but not limited to software source code, documental 
source, and configuration files. 


"Object" form shall mean any form resulting from mechanical 
transformation or translation of a Source form, including but 
not limited to compiled object code, generated documentation, 
and conversions to other media types. 


"Work" shall mean the work of authorship, whether in Source ( 
Object form, made available under the License, as indicated | 
copyright notice that is included in or attached to the work 
(an example is provided in the Appendix below). 


SN 


SNo 


AM. 


"Derivative Works" shall mean any work, whether in Source or 
form, that is based on (or derived from) the Work and for wh: 
editorial revisions, annotations, elaborations, or other mod: 
represent, as a whole, an original work of authorship. For tl 
of this License, Derivative Works shall not include works th: 
separable from, or merely link (or bind by name) to the intei 
the Work and Derivative Works thereof. 


"Contribution" shall mean any work of authorship, including 

the original version of the Work and any modifications or adt 
to that Work or Derivative Works thereof, that is intentiona- 
submitted to Licensor for inclusion in the Work by the copyr: 
or by an individual or Legal Entity authorized to submit on I 
the copyright owner. For the purposes of this definition, "si 
means any form of electronic, verbal, or written communicatic 
to the Licensor or its representatives, including but not lir 
communication on electronic mailing lists, source code Contre 
and issue tracking systems that are managed by, or on behalf 
Licensor for the purpose of discussing and improving the Worl 
excluding communication that is conspicuously marked or othe! 
designated in writing by the copyright owner as "Not a Contr: 


"Contributor" shall mean Licensor and any individual or Lega. 
on behalf of whom a Contribution has been received by Licens 
subsequently incorporated within the Work. 


Grant of Copyright License. Subject to the terms and condit: 
this License, each Contributor hereby grants to You a perpeti 
worldwide, non-exclusive, no-charge, royalty-free, irrevocab: 
copyright license to reproduce, prepare Derivative Works of, 
publicly display, publicly perform, sublicense, and distribut 
Work and such Derivative Works in Source or Object form. 


Grant of Patent License. Subject to the terms and condition: 
this License, each Contributor hereby grants to You a perpeti 
worldwide, non-exclusive, no-charge, royalty-free, irrevocab. 
(except as stated in this section) patent license to make, h: 
use, offer to sell, sell, import, and otherwise transfer the 
where such license applies only to those patent claims licen: 
by such Contributor that are necessarily infringed by their 
Contribution(s) alone or by combination of their Contributior 
with the Work to which such Contribution(s) was submitted. I! 
institute patent litigation against any entity (including a 
cross-claim or counterclaim in a lawsuit) alleging that the v 
or a Contribution incorporated within the Work constitutes d: 
or contributory patent infringement, then any patent license: 
granted to You under this License for that Work shall termin: 
as of the date such litigation is filed. 


Redistribution. You may reproduce and distribute copies of 1 
Work or Derivative Works thereof in any medium, with or with 
modifications, and in Source or Object form, provided that Y« 
meet the following conditions: 


es 


6^. 
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(a) You must give any other recipients of the Work or 
Derivative Works a copy of this License; and 


(b) You must cause any modified files to carry prominent not: 
stating that You changed the files; and 


(c) You must retain, in the Source form of any Derivative Wo! 
that You distribute, all copyright, patent, trademark, ar 
attribution notices from the Source form of the Work, 
excluding those notices that do not pertain to any part « 
the Derivative Works; and 


(d) If the Work includes a "NOTICE" text file as part of its 
distribution, then any Derivative Works that You distribt 
include a readable copy of the attribution notices conta: 
within such NOTICE file, excluding those notices that do 
pertain to any part of the Derivative Works, in at least 
of the following places: within a NOTICE text file distr: 
as part of the Derivative Works; within the Source form « 
documentation, if provided along with the Derivative Worl 
within a display generated by the Derivative Works, if ar 
wherever such third-party notices normally appear. The c« 
of the NOTICE file are for informational purposes only ar 
do not modify the License. You may add Your own attribut: 
notices within Derivative Works that You distribute, alor 
or as an addendum to the NOTICE text from the Work, prov: 
that such additional attribution notices cannot be consti! 
as modifying the License. 


You may add Your own copyright statement to Your modificatior 
may provide additional or different license terms and condit: 
for use, reproduction, or distribution of Your modifications, 
for any such Derivative Works as a whole, provided Your use, 
reproduction, and distribution of the Work otherwise complie: 
the conditions stated in this License. 


Submission of Contributions. Unless You explicitly state otl! 
any Contribution intentionally submitted for inclusion in the 
by You to the Licensor shall be under the terms and conditior 
this License, without any additional terms or conditions. 
Notwithstanding the above, nothing herein shall supersede or 
the terms of any separate license agreement you may have exec 
with Licensor regarding such Contributions. 


Trademarks. This License does not grant permission to use tl 
names, trademarks, service marks, or product names of the Li« 
except as required for reasonable and customary use in descr: 
origin of the Work and reproducing the content of the NOTICE 


Disclaimer of Warranty. Unless required by applicable law o! 
agreed to in writing, Licensor provides the Work (and each 
Contributor provides its Contributions) on an "AS IS" BASIS, 


WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express 
implied, including, without limitation, any warranties or cor 
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR / 
PARTICULAR PURPOSE. You are solely responsible for determinir 
appropriateness of using or redistributing the Work and assur 
risks associated with Your exercise of permissions under thi: 


8\. Limitation of Liability. In no event and under no legal Che 
whether in tort (including negligence), contract, or otherwi: 
unless required by applicable law (such as deliberate and gr« 
negligent acts) or agreed to in writing, shall any Contribut: 
liable to You for damages, including any direct, indirect, sj 
incidental, or consequential damages of any character arising 
result of this License or out of the use or inability to use 
Work (including but not limited to damages for loss of goodw: 
work stoppage, computer failure or malfunction, or any and a- 
other commercial damages or losses), even if such Contributo: 
has been advised of the possibility of such damages. 


9\. Accepting Warranty or Additional Liability. While redistribt 
the Work or Derivative Works thereof, You may choose to offer 
and charge a fee for, acceptance of support, warranty, indemr 
or other liability obligations and/or rights consistent with 
License. However, in accepting such obligations, You may act 
on Your own behalf and on Your sole responsibility, not on be 
of any other Contributor, and only if You agree to indemnify, 
defend, and hold each Contributor harmless for any liability 
incurred by, or claims asserted against, such Contributor by 
of your accepting any such warranty or additional liability. 


END OF TERMS AND CONDITIONS 
APPENDIX: How to apply the Apache License to your work. 


To apply the Apache License to your work, attach the followir 
boilerplate notice, with the fields enclosed by brackets "[]' 
replaced with your own identifying information. (Don't inclut 
the brackets!) The text should be enclosed in the appropriat 
comment syntax for the file format. We also recommend that a 
file or class name and description of purpose be included on 
same "printed page" as the copyright notice for easier 
identification within third-party archives. 


Copyright [yyyy] [name of copyright owner] 

Licensed under the Apache License, Version 2.0 (the "License"); 
you may not use this file except in compliance with the License 
You may obtain a copy of the License at 


http://www.apache.org/licenses/LICENSE-2.0 


Unless required by applicable law or agreed to in writing, softv 
distributed under the License is distributed on an "AS IS" BASI: 


WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 
See the License for the specific language governing permissions 
limitations under the License. 


‘ == 








The Apache Software License, Version 2.0 


Apache License 
Version 2.0, January 2004 
http: //ww.apache.org/licenses/ 


TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION 
1\. Definitions. 


"License" shall mean the terms and conditions for use, repro 
and distribution as defined by Sections 1 through 9 of this « 


"Licensor" shall mean the copyright owner or entity authorize 
the copyright owner that is granting the License. 


"Legal Entity" shall mean the union of the acting entity and 
other entities that control, are controlled by, or are under 
control with that entity. For the purposes of this definitior 
"control" means (i) the power, direct or indirect, to cause 1 
direction or management of such entity, whether by contract « 
otherwise, or (ii) ownership of fifty percent (50%) or more « 
outstanding shares, or (iii) beneficial ownership of such ent 


"You" (or "Your") shall mean an individual or Legal Entity 
exercising permissions granted by this License. 


"Source" form shall mean the preferred form for making modif: 
including but not limited to software source code, documental 
source, and configuration files. 


"Object" form shall mean any form resulting from mechanical 
transformation or translation of a Source form, including but 
not limited to compiled object code, generated documentation, 
and conversions to other media types. 


"Work" shall mean the work of authorship, whether in Source « 
Object form, made available under the License, as indicated | 
copyright notice that is included in or attached to the work 
(an example is provided in the Appendix below). 


"Derivative Works" shall mean any work, whether in Source or 
form, that is based on (or derived from) the Work and for wh: 
editorial revisions, annotations, elaborations, or other mod: 
represent, as a whole, an original work of authorship. For tl 
of this License, Derivative Works shall not include works th: 


2 


SA 


AM. 


separable from, or merely link (or bind by name) to the intei 
the Work and Derivative Works thereof. 


"Contribution" shall mean any work of authorship, including 

the original version of the Work and any modifications or adt 
to that Work or Derivative Works thereof, that is intentiona: 
submitted to Licensor for inclusion in the Work by the copyr: 
or by an individual or Legal Entity authorized to submit on I 
the copyright owner. For the purposes of this definition, "si 
means any form of electronic, verbal, or written communicatic 
to the Licensor or its representatives, including but not lir 
communication on electronic mailing lists, source code Contre 
and issue tracking systems that are managed by, or on behalf 
Licensor for the purpose of discussing and improving the Worl 
excluding communication that is conspicuously marked or othe! 
designated in writing by the copyright owner as "Not a Contr: 


"Contributor" shall mean Licensor and any individual or Lega. 
on behalf of whom a Contribution has been received by Licens 
subsequently incorporated within the Work. 


Grant of Copyright License. Subject to the terms and condit: 
this License, each Contributor hereby grants to You a perpeti 
worldwide, non-exclusive, no-charge, royalty-free, irrevocab: 
copyright license to reproduce, prepare Derivative Works of, 
publicly display, publicly perform, sublicense, and distribut 
Work and such Derivative Works in Source or Object form. 


Grant of Patent License. Subject to the terms and condition: 
this License, each Contributor hereby grants to You a perpeti 
worldwide, non-exclusive, no-charge, royalty-free, irrevocab: 
(except as stated in this section) patent license to make, h: 
use, offer to sell, sell, import, and otherwise transfer the 
where such license applies only to those patent claims licen: 
by such Contributor that are necessarily infringed by their 
Contribution(s) alone or by combination of their Contributior 
with the Work to which such Contribution(s) was submitted. I! 
institute patent litigation against any entity (including a 
cross-claim or counterclaim in a lawsuit) alleging that the \ 
or a Contribution incorporated within the Work constitutes d: 
or contributory patent infringement, then any patent license: 
granted to You under this License for that Work shall termin: 
as of the date such litigation is filed. 


Redistribution. You may reproduce and distribute copies of 1 
Work or Derivative Works thereof in any medium, with or with: 
modifications, and in Source or Object form, provided that Y« 
meet the following conditions: 


(a) You must give any other recipients of the Work or 
Derivative Works a copy of this License; and 


(b) You must cause any modified files to carry prominent not: 


5N: 


6\. 


ZANA 


stating that You changed the files; and 


(c) You must retain, in the Source form of any Derivative Wo! 
that You distribute, all copyright, patent, trademark, ar 
attribution notices from the Source form of the Work, 
excluding those notices that do not pertain to any part « 
the Derivative Works; and 


(d) If the Work includes a "NOTICE" text file as part of its 
distribution, then any Derivative Works that You distribt 
include a readable copy of the attribution notices conta: 
within such NOTICE file, excluding those notices that do 
pertain to any part of the Derivative Works, in at least 
of the following places: within a NOTICE text file distr: 
as part of the Derivative Works; within the Source form « 
documentation, if provided along with the Derivative Worl 
within a display generated by the Derivative Works, if ar 
wherever such third-party notices normally appear. The c« 
of the NOTICE file are for informational purposes only ar 
do not modify the License. You may add Your own attribut: 
notices within Derivative Works that You distribute, alor 
or as an addendum to the NOTICE text from the Work, prov: 
that such additional attribution notices cannot be consti! 
as modifying the License. 


You may add Your own copyright statement to Your modificatior 
may provide additional or different license terms and condit: 
for use, reproduction, or distribution of Your modifications, 
for any such Derivative Works as a whole, provided Your use, 
reproduction, and distribution of the Work otherwise complie: 
the conditions stated in this License. 


Submission of Contributions. Unless You explicitly state otl! 
any Contribution intentionally submitted for inclusion in the 
by You to the Licensor shall be under the terms and conditior 
this License, without any additional terms or conditions. 
Notwithstanding the above, nothing herein shall supersede or 
the terms of any separate license agreement you may have exec 
with Licensor regarding such Contributions. 


Trademarks. This License does not grant permission to use tl 
names, trademarks, service marks, or product names of the Li« 
except as required for reasonable and customary use in descr: 
origin of the Work and reproducing the content of the NOTICE 


Disclaimer of Warranty. Unless required by applicable law o! 
agreed to in writing, Licensor provides the Work (and each 
Contributor provides its Contributions) on an "AS IS" BASIS, 
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express 
implied, including, without limitation, any warranties or cor 
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR / 
PARTICULAR PURPOSE. You are solely responsible for determinir 
appropriateness of using or redistributing the Work and assur 


risks associated with Your exercise of permissions under thi: 


8\. Limitation of Liability. In no event and under no legal Che 
whether in tort (including negligence), contract, or otherwi: 
unless required by applicable law (such as deliberate and gor 
negligent acts) or agreed to in writing, shall any Contribut: 
liable to You for damages, including any direct, indirect, sj 
incidental, or consequential damages of any character arising 
result of this License or out of the use or inability to use 
Work (including but not limited to damages for loss of goodw: 
work stoppage, computer failure or malfunction, or any and a- 
other commercial damages or losses), even if such Contributo: 
has been advised of the possibility of such damages. 


9\. Accepting Warranty or Additional Liability. While redistribt 
the Work or Derivative Works thereof, You may choose to offe! 
and charge a fee for, acceptance of support, warranty, indemr 
or other liability obligations and/or rights consistent with 
License. However, in accepting such obligations, You may act 
on Your own behalf and on Your sole responsibility, not on be 
of any other Contributor, and only if You agree to indemnify, 
defend, and hold each Contributor harmless for any liability 
incurred by, or claims asserted against, such Contributor by 
of your accepting any such warranty or additional liability. 


END OF TERMS AND CONDITIONS 
APPENDIX: How to apply the Apache License to your work. 


To apply the Apache License to your work, attach the followir 
boilerplate notice, with the fields enclosed by brackets "[]' 
replaced with your own identifying information. (Don't inclut 
the brackets!) The text should be enclosed in the appropriat 
comment syntax for the file format. We also recommend that a 
file or class name and description of purpose be included on 
same "printed page" as the copyright notice for easier 
identification within third-party archives. 


Copyright [yyyy] [name of copyright owner] 


Licensed under the Apache License, Version 2.0 (the "License"); 
you may not use this file except in compliance with the License 
You may obtain a copy of the License at 


http://www.apache.org/licenses/LICENSE-2.0 


Unless required by applicable law or agreed to in writing, softv 
distributed under the License is distributed on an "AS IS" BASI: 
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or 
See the License for the specific language governing permissions 
limitations under the License. 
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项 目 邮 件 列表 


这 些 是 本 项 目 建 立 的 邮件 列表 。 每 个 列表 都 有 一 个 订阅 、 退 订 和 为 档 的 链接 。 


名 称 


mybatis- 
dev 


mybatis- 
USer 


mybatis- 
commits 


Y 
H 


St 
H 


Y 
H 


iT 
阅 


取 
消 
iT 
阅 
取 
消 
订 
阅 
取 
消 
iT 
阅 
取 
消 
iT 
阅 


J45 


groups.google.com 


groups.google.com 


groups.google.com 


其 他 为 档 


mybatis- 
user.963551.n3.nabble.com 


Project Plugin Management 


Groupld 
com.mycila 
org.apache.maven.plugins 
org.apache.maven.plugins 
org.apache.maven.plugins 


org.apache.maven.plugins 
org.apache.maven.plugins 


org.apache.maven.plugins 
org.apache.maven.plugins 
org.apache.maven.plugins 
org.apache.maven.plugins 
org.apache.maven.plugins 
org.apache.maven.plugins 
org.apache.maven.plugins 
org.apache.maven.plugins 


org.codehaus.mojo 


org.jacoco 


Project Plugin Management 


Artifactld 
license-maven-plugin 
maven-antrun-plugin 
maven-assembly-plugin 
maven-clean-plugin 
maven-compiler-plugin 


maven-dependency- 
plugin 


maven-deploy-plugin 
maven-install-plugin 
maven-paf-plugin 
maven-release-plugin 
maven-resources-plugin 
maven-shade-plugin 
maven-site-plugin 
maven-surefire-plugin 
versions-maven-plugin 


http://jacoco-maven- 
plugin 


Version 
2.11 
1.8 
2:5.5 
2.6.1 
3:3 


210 


2.8.2 
2:5.2 
1.3 
2.9.2 
2.7 
24 
34 
2.18.1 
2.2 


0.7.5.201505241946 


e 
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Project Build Plugins 


Groupld 
com.mycila 
org.apache.felix 
org.apache.maven.plugins 
org.apache.maven.plugins 
org.apache.maven.plugins 
org.apache.maven.plugins 
org.apache.maven.plugins 
org.apache.maven.plugins 
org.apache.maven.plugins 
org.apache.maven.plugins 
org.apache.maven.plugins 
org.apache.maven.plugins 
org.apache.maven.plugins 


org.apache.maven.plugins 
org.codehaus.mojo 
org.codehaus.mojo 


org.jacoco 





Project Build Plugins 


Artifactld 
license-maven-plugin 
maven-bundle-plugin 
maven-clean-plugin 
maven-compiler-plugin 
maven-deploy-plugin 
maven-enforcer-plugin 
maven-install-plugin 
maven-jar-plugin 
maven-paf-plugin 
maven-resources-plugin 
maven-scm-plugin 
maven-shade-plugin 
maven-site-plugin 
maven-surefire-plugin 


animal-sniffer-maven- 
plugin 
clirr-maven-plugin 


http://jacoco-maven- 
plugin 


Version 


2.11 


2.54 


2.6.1 


2.8.2 


2:9:2 


2.6.1 


0.7.5.201505241946 
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Project Report Plugins 


Groupld 
org.apache.maven.plugins 
org.apache.maven.plugins 
org.apache.maven.plugins 


org.apache.maven.plugins 


org.apache.maven.plugins 


org.apache.maven.plugins 


org.codehaus.mojo 
org.codehaus.mojo 
org.codehaus.mojo 
org.codehaus.mojo 


org.codehaus.mojo 


org.jacoco 


oject Report Plugins 


Artifactld 
maven-changes-plugin 
maven-javadoc-plugin 
maven-jxr-plugin 
maven-pmd-plugin 


maven-project-info- 
reports-plugin 


maven-surefire-report- 
plugin 
clirr-maven-plugin 
findbugs-maven-plugin 
jdepend-maven-plugin 
taglist-maven-plugin 
versions-maven-plugin 


http://jacoco-maven- 
plugin 


2.11 
ZNO 
2.5 
34 


2.8 


2.18.1 


2.6.1 
3.0.1 
2.0 
24 
2.2 


Version 


0.7.5.201505241946 
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团队 


一 个 成 功 的 项 目 要求 许 多 人 扮演 许多 的 角色 。 其 中 一 些 成 员 编写 代码 或 者 文档 ， 同 
时 其 他 成 员 则 通过 测试 、 打 补丁 以 及 提 建 议 等 方式 实现 自己 的 价值 。 


一 个 团队 由 团队 成 员 以 及 贡献 者 组 成 。 团 队 成 员 直 接 访 问 项 目的 源 代 码 并 积极 地 参 
与 编码 工作 。 贡 献 者 则 通过 向 成 员 提交 补丁 和 提出 建议 来 完善 项 目 。 一 个 项 目 中 贡 
献 者 的 数量 是 不 限 的 。 请 立刻 加 入 到 贡献 行列 中 来 吧 。 囊 心 感谢 所 有 对 项 目 做 出 贡 


献 的 人 。 


成 员 


以 下 是 开发 者 的 列表 ， 他 们 有 提交 的 权限 ， 在 项 目 中 以 某 种 方式 直接 做 出 了 贡献 。 


Image 





cbegin 


brandon.goodin 


mentat6114 


emacarron 


mnesarco 


agustafson 


hpresnall 


harawata 


jeffgbutler 


姓名 


Clinton 
Begin 


Brandon 
Goodin 


Christian 
Poitras 


Eduardo 
Macarron 


Frank 
Martinez 


Andrew 
Gustafson 


Hunter 
Presnall 


Iwao Ave 


Jeff Butler 


电子 邮件 


clinton.begin@gmail.com 


brandon.goodin@gmail.co 


christian.poitras@ircm.qc.¢ 


eduardo.macarron@gmail. 


mnesarco@gmail.com 


gus4000@gmail.com 


hpresnall@gmail.com 


harawata@gmail.com 


jeffgbutler@gmail.com 


贡献 者 


nospam@kaigrabfelder.de 


Imeadors 


marcosperanza 


nmaves 


putthibongb 


simonetripodi 


h3adache 


Jeremy 
Landis 


Kai 
Grabfelder 


Larry 
Meadors 


Marco 
Speranza 


Nathan 
Maves 


Putthibong 
Boonbong 


Simone 
Tripodi 


Tim Chen 


jeremylandis@hotmail.con 


nospam@kaigrabfelder.de 


larry. meadors@gmail.com 


marco.speranza79@gmail 


nathan.maves@gmail.com 


putthibongb@gmail.com 


simone.tripodi@gmail.com 


chengt@gmail.com 


以 下 的 其 他 人 通过 建议 ， 补 丁 或 者 文档 对 本 项 目 做 出 了 贡献 。 


Image 


姓名 


Adam Gent 


Andrea Selva 


Antonio Sanchez 


Arkadi Shishlov 


电子 邮件 


adam.gent@evocatus.com 


selva.andre@gmail.com 


juntandolineas@gmail.com 


arkadi.shishlov@gmail.com 
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Axel Doerfler axel.doerfler@gmail.com 

^ 

^ Chris Dadej chris.dadej@gmail.com 
Denis Vygovskiy qizant@gmail.com 

= Franta Mejta mejta@rewor.cz 
E Jurriaan Pruys jurriaan@pruys.com 

Keith Wong wongkwi@gmail.com 
Lasse Voss lasse.voss@motor-talk-gmbh.de 
Luke Stevens nosuchluke@gmail.com 
Paul Krause paulkrause88@alum.mit.edu 
Peter Leibiger kuhnroyal@gmail.com 
Riccardo Cossu riccardo.cossu@gmail.com 
Toma? Neuberg neuberg@m-atelier.cz 


成 员 
以 下 是 开发 者 的 列表 ， 他 们 有 提交 的 权限 ， 在 项 目 中 以 某 种 方式 直接 做 出 了 贡献 。 
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团队 


cbegin 


brandon.goodin 


mentat6114 


emacarron 


mnesarco 


agustafson 


hpresnall 


harawata 


jeffgbutler 


hazendaz 


nospam@kaigrabfelder.de 


Imeadors 


marcosperanza 


nmaves 


putthibongb 


Clinton 
Begin 


Brandon 
Goodin 


Christian 
Poitras 


Eduardo 
Macarron 


Frank 
Martinez 


Andrew 
Gustafson 


Hunter 
Presnall 


Iwao Ave 


Jeff Butler 


Jeremy 
Landis 


Kai 
Grabfelder 


Larry 
Meadors 


Marco 
Speranza 


Nathan 
Maves 


Putthibong 
Boonbong 


clinton.begin@gmail.com 


brandon.goodin@gmail.co 


christian.poitras@ircm.qc.¢ 


eduardo.macarron@gmail. 


mnesarco@gmail.com 


gus4000@gmail.com 


hpresnall@gmail.com 


harawata@gmail.com 


jeffgbutler@gmail.com 


jeremylandis@hotmail.con 


nospam@kaigrabfelder.de 


larry. meadors@gmail.com 


marco.speranza79@gmail 


nathan.maves@gmail.com 


putthibongb@gmail.com 
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A 27 SS 

ere Simone aoe : 
EN simonetripodi Tripodi simone.tripodi@gmail.com 
h3adache Tim Chen chengt@gmail.com 


贡献 者 
以 下 的 其 他 人 通过 建议 ， 补 丁 或 者 文档 对 本 项 目 做 出 了 贡献 。 


Image 姓名 电子 邮件 
Y. 
Adam Gent adam.gent@evocatus.com 
Andrea Selva selva.andre@gmail.com 
Antonio Sanchez juntandolineas@gmail.com 
A Arkadi Shishlov arkadi.shishlov@gmail.com 
Axel Doerfler axel.doerfler@gmail.com 
a 
+ Chris Dadej chris.dadej@gmail.com 
Denis Vygovskiy qizant@gmail.com 
l>e Franta Mejta mejta@rewor.cz 
E Jurriaan Pruys jurriaan@pruys.com 
Keith Wong wongkwl@gmail.com 
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团队 





Keith Wong 


Lasse Voss 


Luke Stevens 


Paul Krause 


Peter Leibiger 


Riccardo Cossu 


Tomá? Neuberg 


wongkwl@gmail.com 


lasse.voss@motor-talk-gmbh.de 


nosuchluke@gmail.com 


paulkrause88@alum.mit.edu 


kuhnroyal@gmail.com 


riccardo.cossu@gmail.com 


neuberg@m-atelier.cz 
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概述 


This project uses Git to manage its source code. Instructions on Git use can be 
found at http://git-scm.com/documentation. 


Web; i] 
以 下 是 在 线 源 代码 库 的 链接 。 


[http://github.com/mybatis/mybatis-3](http://github.com/mybatis/myt 
BEER 





匿名 访问 


The source can be checked out anonymously from Git with this command (See 
http://git-sem.com/docs/git-clone): 


$ git clone ssh://github.com/mybatis/mybatis-3.git 


开发 者 访问 


Only project developers can access the Git tree via this method (See http://git- 
scm.com/docs/git-clone). 


$ git clone ssh://gitQgithub.com/mybatis/mybatis-3.git 


通过 防火 墙 访 问 


请 参考 使 用 的 源 代码 管理 工具 的 文档 以 获得 更 多 的 通过 防火 墙 进行 访问 的 信息 。 


项 目 概要 


项 E 信 息 


称 mybatis 


The MyBatis data mapper framework makes it easier to use a relational 
database with object-oriented applications. MyBatis couples objects with 


de stored procedures or SQL statements using a XML descriptor or 
* annotations. Simplicity is the biggest advantage of the MyBatis data 
mapper over object relational mapping tools. 
= http://www.mybatis.org/core/ 
A 
oh E ZB. 28 
FE 值 
名 称 MyBatis.org 
URL http://www.mybatis.org/ 
构建 信息 
字段 值 
Groupld org.mybatis 
Artifactld mybatis 
版 本 3.4.0-SNAPSHOT 
类 型 jar 
Java Version 1.6 


项 E 5 A 


mybatis 


The MyBatis data mapper framework makes it easier to use a relational 
database with object-oriented applications. MyBatis couples objects with 
stored procedures or SQL statements using a XML descriptor or 
annotations. Simplicity is the biggest advantage of the MyBatis data 
mapper over object relational mapping tools. 


http://www.mybatis.org/core/ 


= D 


项 目 组 织 


名 称 MyBatis.org 
URL http://www.mybatis.org/ 


构建 信息 


Groupld org.mybatis 
Artifactld mybatis 

版 本 3.4.0-SNAPSHOT 
类 型 jar 


Java Version 1.6 


生成 报表 


本 文档 提供 了 对 项 目 中 各 种 报表 的 概述 ， 这 些 报 表 生 成 自 Maven 每 一 个 报表 在 以 
下 简要 介绍 。 


文档 描述 
JavaDocs JavaDoc API documentation. 


Source Xref 


Test Source 
Xref 


HTML based, cross-reference version of Java source code. 


HTML based, cross-reference version of Java test source 
code. 


JDepend traverses Java class file directories and generates 
design quality metrics for each Java package. JDepend allows 


JDepend you to automatically measure the quality of a design in terms 
of its extensibility, reusability, and maintainability to manage 
package dependencies effectively. 

FindBugs Generates a source code report with the FindBugs Library. 

Surefire 

Report Report on the test results of the project. 

CPD Duplicate code detection. 

PMD Verification of coding rules. 

Tag List Report on various tags found in the code. 

Clirr Report on binary and source API differences between 
releases 

Te Provides details of the dependencies which have updated 

ai versions available. 

Report 

Plugin : : : ; 

Uodat Provides details of the plugins used by this project which have 

BA? newer versions available. 

Report 

Property Provides details of properties which control versions of 

Updates dependencies and/or plugins, and indicates any newer 

Report versions which are available. 


概述 


文档 
JavaDocs 
Source Xref 


Test Source 
Xref 


JDepend 


FindBugs 


Surefire 
Report 


CPD 
PMD 
Tag List 


Clirr 


Dependency 
Updates 
Report 


Plugin 
Updates 
Report 


Property 
Updates 
Report 


JavaDoc API documentation. 
HTML based, cross-reference version of Java source code. 


HTML based, cross-reference version of Java test source 
code. 


JDepend traverses Java class file directories and generates 
design quality metrics for each Java package. JDepend allows 
you to automatically measure the quality of a design in terms 
of its extensibility, reusability, and maintainability to manage 
package dependencies effectively. 


Generates a source code report with the FindBugs Library. 
Report on the test results of the project. 


Duplicate code detection. 
Verification of coding rules. 
Report on various tags found in the code. 


Report on binary and source API differences between 
releases 


Provides details of the dependencies which have updated 
versions available. 


Provides details of the plugins used by this project which have 
newer versions available. 


Provides details of properties which control versions of 
dependencies and/or plugins, and indicates any newer 
versions which are available. 


